NWDSRemoveAllTypes

Removes all attribute types from a distinguished 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 <nwdsname.h> 
   
  N_EXTERN_LIBRARY (NWDSCCODE)  NWDSRemoveAllTypes  ( 
     NWDSContextHandle   context,  
     pnstr8              name,  
     pnstr8              typelessName);

Pascal

  uses netwin32 
   
  Function NWDSRemoveAllTypes 
    (context : NWDSContextHandle; 
     name : pnstr8; 
     typelessName : pnstr8 
  ) : NWDSCCODE;

Parameters

context: (IN) Specifies the NDS context for the request.
name: (IN) Points to the object name.
typelessName: (OUT) Points to the object name with the attribute types removed.

Return Values

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

Remarks

NWDSRemoveAllTypes takes the typed name

       CN=Bob.OU=Marketing.O=WimpleMakers

and returns the untyped name

       Bob.Marketing.WimpleMakers

Removal of types is not done relative to the current name context. Therefore, it is not guaranteed that NWDSCanonicalizeName can restore the correct types. For more information, see the DCV_TYPELESS_NAMES key in DCK_FLAGS Key.

The caller must allocate the memory pointed to by typelessName. The size of the memory is (MAX_DN_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 is already untyped, the same untyped name will be returned.

NCP Calls

None