NWDSGetSyntaxCount

Returns the number of eDirectory syntaxes whose information is stored in a result buffer filled by NWDSReadSyntaxes.

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)  NWDSGetSyntaxCount  ( 
     NWDSContextHandle   context,  
     pBuf_T              buf,  
     pnuint32            syntaxCount);

Pascal

  uses netwin32 
   
  Function NWDSGetSyntaxCount 
    (context : NWDSContextHandle; 
     buf : pBuf_T; 
     syntaxCount : pnuint32 
  ) : NWDSCCODE;

Parameters

context: (IN) Specifies the NDS context for the request.
buf: (IN) Points to the buffer being read.
syntaxCount: (OUT) Points to the number of syntaxes stored in the buffer.

Return Values

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

Remarks

Before reading the syntax information from a result buffer filled by NWDSReadSyntaxes, you must first call NWDSGetSyntaxCount to determine the number of syntaxes whose information is stored in the buffer.

When NWDSGetSyntaxCount returns, the location pointed to by syntaxCount specifies the number of syntaxes whose information is stored in the buffer. To remove the syntax information from the result buffer, call NWDSGetSyntaxDef once for each syntax whose information is stored in the buffer.

For complete steps on retrieving information about the syntaxes in the eDirectory schema, see Retrieving Syntax Names and Definitions.

NCP Calls

None