NWDSGetSyntaxCount(3nw)


NWDSGetSyntaxCount -- returns number of directory syntaxes stored in result buffer

Synopsis

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

NWDSCCODE N_API NWDSGetSyntaxCount (NWDSContextHandle context, pBuf_T buf, pnuint32 syntaxCount);

Description

The parameters are as follows:

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

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.

The complete steps for retrieving information about the syntaxes in the Directory Schema are listed in the reference for NWDSReadSyntaxes.

Services

Directory

NCP calls

None

References

NWDSGetSyntaxDef(3nw), NWDSReadSyntaxes(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.