NWDSReplaceAttrNameAbbrev

Replaces the abbreviated attribute name with its unabbreviated name.

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 <nwdsmisc.h> 
   
  N_EXTERN_LIBRARY (NWDSCCODE)  NWDSReplaceAttrNameAbbrev  ( 
     NWDSContextHandle   context,  
     pnstr8              inStr,  
     pnstr8              outStr);

Pascal

  uses netwin32 
   
  Function NWDSReplaceAttrNameAbbrev 
    (context : NWDSContextHandle; 
     inStr : pnstr8; 
     outStr : pnstr8 
  ) : NWDSCCODE;

Parameters

context: (IN) Specifies the NDS context of the request.
inStr: (IN) Points to attrName.
outStr: (OUT) Points to the long form of the attribute name.

Return Values

0x0000 0000	SUCCESSFUL
nonzero value	Nonzero values indicate errors. See NDS Return Values (–001 to –799).

Remarks

NWDSReadClassDef returns the abbreviated form of some of the common naming attributes (CN, C, O, OU, L, S, and SA). The long form of these attributes (Common Name, Country Name, Organization Name, Organizational Unit Name, and so on) is returned from NWDSReplaceAttrNameAbbrev and pointed to by outStr.

The user must allocate space for the long form of the attribute name. The size of the allocated memory is

       ((MAX_SCHEMA_NAME_CHARS)+1)*sizeof(character size)

where character size is 1 for single-byte characters, and 2 for Unicode characters (Unicode characters are always 16 bits). One character is used for NULL termination.

If the name pointed to by inStr is not an abbreviated name, the contents of inStr will be copied to outStr.

NCP Calls

None