NWDSRemoveAllTypes(3nw)


NWDSRemoveAllTypes -- removes all attribute types from a distinguished name

Synopsis

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

NWDSCCODE N_API NWDSRemoveAllTypes (NWDSContextHandle context, pnstr8 name, pnstr8 typelessName);

Description

The parameters are as follows:

context
(IN) Specifies the Directory 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
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

An example of removing types is 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.

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 double-byte characters (Unicode is double byte). One character is used for NULL termination.

If the name is already untyped, the same untyped name will be returned.

Services

Directory

NCP calls

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