NWDSCompare

Compares an object’s attribute value with a specified value.

Local Servers:blocking
Remote Servers:blocking
NetWare Server:4.x, 5.x, 6.x
Platform:NLM, Windows NT, Windows 95, Windows 98, Windows 2000, Windows XP
Library:Cross-Platform NDS (NET*.*)
Service:NDS

Syntax

C

  #include <nwnet.h> 
  or 
  #include <nwdsdsa.h> 
   
  N_EXTERN_LIBRARY (NWDSCCODE)  NWDSCompare  ( 
     NWDSContextHandle   context,  
     pnstr8              object,  
     pBuf_T              buf,  
     pnbool8             matched);

Pascal

  uses netwin32 
   
  Function NWDSCompare 
    (context : NWDSContextHandle; 
     objectName : pnstr8; 
     buf : pBuf_T; 
     matched : pnbool8 
  ) : NWDSCCODE;

Parameters

context

(IN) Specifies the NDS context for the request.

object

(IN) Points to the name of the object whose attribute is being compared.

buf

(IN) Points to a request buffer containing the attribute name and value to be compared with the object’s attribute value.

matched

(OUT) Points to a boolean value indicating the result of the comparison.

Return Values

0x0000 0000

SUCCESSFUL

0x8996

SERVER_OUT_OF_MEMORY

0x89E2

TOO_FEW_FRAGMENTS

0x89E3

TOO_MANY_FRAGMENTS

0x89E4

PROTOCOL_VIOLATION

0x89E5

SIZE_LIMIT_EXCEEDED

0x89FD

UNKNOWN_REQUEST

0x89FD

INVALID_PACKET_LENGTH

0x89FE

BAD_PACKET

0x89FF

Failure not related to eDirectory

nonzero value

Nonzero values indicate errors. See NDS Return Values (–001 to –799).

Remarks

The comparison is in the form of "attribute name = attribute value." For example, the attribute name "Description" and the value "PostScript" might be used to determine if a particular printer’s page description language is PostScript.

The input buffer, buf, should be allocated with the NWDSAllocBuf function and initialized for the DSV_COMPARE operation with the NWDSInitBuf function.

The matched parameter receives a Boolean indicating the result of the comparison. The result is TRUE if the comparison was successful; otherwise, the result is FALSE.

For step-by-step instructions, see Comparing Attribute Values.

NCP Calls

See Also

NWDSRead