NWDSDefineAttr

Adds a new attribute definition to the eDirectory schema.

Local Servers:blocking

Remote Servers:blocking

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 <nwdssch.h> 
   
  N_EXTERN_LIBRARY (NWDSCCODE)  NWDSDefineAttr  ( 
     NWDSContextHandle   context,  
     pnstr8              attrName,  
     pAttr_Info_T        attrDef);

Pascal

  uses netwin32 
   
  Function NWDSDefineAttr 
    (context : NWDSContextHandle; 
     attrName : pnstr8; 
     attrDef : pAttr_Info_T 
  ) : NWDSCCODE;

Parameters

context: (IN) Specifies the NDS context for the request.
attrName: (IN) Points to the name for the new attribute.
attrDef: (IN) Points to the remaining information for the new attribute definition.

Return Values

These are common return values.

0x0000 0000	SUCCESSFUL
0x8996	SERVER_OUT_OF_MEMORY
0x89E2	TOO_FEW_FRAGMENTS
0x89E3	TOO_MANY_FRAGMENTS
0x89E4	PROTOCOL_VIOLATION
0x89E5	SIZE_LIMIT_EXCEEDED
0x89FD	UNKNOWN_REQUEST
0x89FD	INVALID_PACKET_LENGTH
0x89FE	BAD_PACKET
0x89FF	Failure not related to eDirectory
nonzero value	Nonzero values indicate errors. See NDS Return Values (–001 to –799).

Remarks

The name of the new attribute must be unique within the eDirectory schema attribute definitions. The names of the attributes for the base schema are listed in Base Attribute Definitions (NDK: Novell eDirectory Schema Reference). New attributes added by other applications must be read from the schema on a server by calling NWDSReadAttrDef.

New attribute names should be cleared through Novell Developer Support to guarantee uniqueness.

NCP Calls

0x2222 23 17 Get File Server Information
0x2222 23 22 Get Station’s Logged Info (old)
0x2222 23 28 Get Station’s Logged Info
0x2222 104 01 Ping for eDirectory NCP
0x2222 104 02 Send eDirectory Fragmented Request/Reply