NWDSGetClassDef

Retrieves an object-class definition from a result buffer.

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 <nwdsbuft.h> 
   
  N_EXTERN_LIBRARY (NWDSCCODE)  NWDSGetClassDef  ( 
     NWDSContextHandle   context,  
     pBuf_T              buf,  
     pnstr8              className,  
     pClass_Info_T       classInfo);

Pascal

  uses netwin32 
   
  Function NWDSGetClassDef 
    (context : NWDSContextHandle; 
     buf : pBuf_T; 
     className : pnstr8; 
     classInfo : pClass_Info_T 
  ) : NWDSCCODE;

Parameters

context: (IN) Specifies the NDS context for the request.
buf: (IN) Points to the result buffer being read.
className: (OUT) Points to the name of the object-class definition at the current position in the buffer.
classInfo: (OUT) Points to the initial portion of the object-class definition.

Return Values

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

Remarks

NWDSGetClassDef is used to retrieve class definitions from a result buffer filled in by NWDSReadClassDef.

The className parameter points to the name of the current class in the buffer. You must allocate space for the class name. The size of the allocated memory is ((MAX_SCHEMA_NAME_CHARS)+1)*sizeof(characters 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 NWDSReadClassDef is called with infoType set to DS_CLASS_DEF_NAMES, classInfo of NWDSGetClassDef is ignored and can be NULL.

For the complete steps on retrieving class information, see Reading a Class Definition.

NCP Calls

None