NWDSGetCountByClassAndName(3nw)

Synopsis

   #include <nwnet.h> 
   or 
   #include <nwdsdsa.h> 
   
 
   NWDSCCODE N_API NWDSGetCountByClassAndName 
     (NWDSContextHandle   context, 
      pnstr8              objectName, 
      pnstr8              className, 
      pnstr8              subordinateName, 
      pnuint32            count); 

Description

context

(IN) Specifies the Directory Services context for the request.

objectName

(IN) Points to the object name whose subordinates are to be counted.

className

(IN) Points to the class name to be used as a filter when determining which objects should be counted.

subordinateName

(IN) Points to a name to be used as a filter when determining which objects should be counted.

count

(OUT) Points to the count of subordinate objects matching the filters.

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).

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 Directory Services

Notices

The location of the subordinate object(s) in the Directory tree is immediately subordinate to the object specified by objectName. It is not relative to the current name context in the Directory context specified by context.

The relationship between className and subordinateName is an AND relationship.

When className and subordinateName are provided, a count of immediate subordinate objects restricted by both filters is returned.

When className is NULL and subordinateName is NULL, the count of all immediate subordinates is returned.

When className is provided and subordinateName is NULL, the count of immediate subordinates restricted only by className's filter is returned.

When subordinateName is provided and className is NULL, the count of immediate subordinates restricted only by subordinateName is returned.

The following examples show how to use wildcards for untyped names:

c

Any object whose left-most name begins with a ``c'' character.

My

Any object beginning with ``M'' and ending with``y'' such as Mary.

cn=

Any object whose left-most name is a common name.

cn=c

Any object whose left-most name is a common name and begin with ``c.''

o=

Any object whose naming attribute is of a type beginning with an ``o,'' such as O or OU.

o=c

Any object whose left-most name is of a type beginning with an ``o,'' and whose name begins with ``c.''

Services

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 NDS NCP

0x2222 104 02

Send NDS Fragmented Request/Reply

References