NWDSAbbreviateName

Converts an NDS name (including the naming attributes) to its shortest form relative to a specified name context.

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> 
  #include <nwdsbuft.h> 
   
  N_EXTERN_LIBRARY (NWDSCCODE)  NWDSAbbreviateName  ( 
     NWDSContextHandle   context,  
     pnstr8              inName,  
     pnstr8              abbreviatedName);

Pascal

  uses netwin32 
   
  Function NWDSAbbreviateName 
    (context : NWDSContextHandle; 
     inName : pnstr8; 
     abbreviatedName : pnstr8 
  ) : NWDSCCODE;

Parameters

context: (IN) Specifies the NDS 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 0000	SUCCESSFUL
nonzero value	Nonzero values indicate errors. See NDS Return Values (–001 to –799).

Remarks

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 Unicode characters (Unicode characters are always 16 bits). 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

with a context of 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.

NCP Calls

None