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.