NWDSReplaceAttrNameAbbrev(3nw)


NWDSReplaceAttrNameAbbrev -- replaces the abbreviated attribute name with its unabbreviated name

Synopsis

   #include <nwnet.h> 
   or 
   #include <nwdsmisc.h> 
   

NWDSCCODE N_API NWDSReplaceAttrNameAbbrev (NWDSContextHandle context, pnstr8 inStr, pnstr8 outStr);

Description

The parameters are as follows:

context
(IN) Specifies the Directory context of the request.

inStr
(IN) Points to attrName.

outStr
(OUT) Points to the long form of the attribute name.

Return values

0x0000
SUCCESSFUL

Negative Value
Negative values indicate errors. For errors returned by Directory Services, see ``Directory Services OS Errors'' (-001 to -255), ``Directory Services Client Library Errors'' (-301 to -399), or ``Directory Services Agent in the Server Errors'' (-601 to -699).

Notices

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 double-byte characters (Unicode is double-byte). 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.

Services

Directory

NCP calls

None
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.