NWDSAbbreviateName(3nw)


NWDSAbbreviateName -- converts a Directory name (including the name's naming attributes) to its shortest form relative to a specified name context

Synopsis

   #include <nwnet.h> 
   or 
   #include <nwdsname.h> 
   #include <nwdsbuft.h> 
   

NWDSCCODE N_API NWDSAbbreviateName (NWDSContextHandle context, pnstr8 inName, pnstr8 abbreviatedName);

Description

The parameters are as follows:

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

inName
(IN) Points to the object name to be abbreviated.

abbreviatedName
(OUT) Points to the abbreviated form of the 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

The caller must allocate space for the abbreviated name. The size of the allocated memory is ((MAX_RDN_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 context flag associated with DCV_TYPELESS_NAMES is set on, the types are removed where possible. For example, the name

   CN=Elmer Fudd.OU=Looney Tunes.O=Acme (context OU=Looney Tunes.O=Acme) 

converts to

   Elmer Fudd. 

If the context flag associated with DCV_TYPELESS_NAMES is set off, the name converts to

   CN=Elmer Fudd. 

Services

Directory

NCP calls

None

References

NWDSCanonicalizeName(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.