NWDSCIStringsMatch

Tests two case ignore strings (defined by CI_String_T ) to determine if the two strings are equivalent.

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 <nwdsname.h> 
   
  N_EXTERN_LIBRARY (NWDSCCODE)  NWDSCIStringsMatch  ( 
     NWDSContextHandle   context,  
     pnstr8              string1,  
     pnstr8              string2,  
     pnint               matches ;)

Pascal

  uses netwin32 
   
  Function NWDSCIStringsMatch 
    (context : NWDSContextHandle; 
     string1 : pnstr8; 
     string2 : pnstr8; 
     matches : pnint 
  ) : NWDSCCODE;

Parameters

context: (IN) Specifies the NDS context to be used. It is created by calling NWDSCreateContextHandle.
string1: (IN) Points to the first string to compare.
string2: (IN) Points to the second string to compare.
matches: (OUT) Points to a boolean indicating whether the strings match: 0 = Don’t match; 1 = Match.

Return Values

These are common return values.

0x0000 0000	SUCCESSFUL
0xFE0D	UNI_NO_DEAFAULT
0xFE0F	UNI_HANDLE_MISMATCH
0xFE10	UNI_HANDLE_BAD
0xFED1	ERR_BAD_CONTEXT
0xFED3	ERR_NOT_ENOUGH_MEMORY

Remarks

Case Ignore String is a syntax used by some of the eDirectory attributes such as CN, Description, Given Name, Surname, and Title.

Depending on the setting of the DCV_XLATE_STRINGS context key, NWDSCIStringsMatch compares two strings either in the local or Unicode code page. This function ignores leading and trailing white space, which is either " " (space, 0x0020) or "_" (underscore, 0x005F). Also, it matches any consecutive internal white space, regardless of quantities. For example, if the string has a single internal white space character and another has five, NWDSCIStringsMatch matches the strings. Finally, NWDSCIStringsMatch ignores case in comparisons.

NWDSCIStringsMatch is a local function.

NCP Calls

None