Since a server may not be able to reply to all the requested DSPING flags, the DSPING_SUPPORTED_FIELDS should always be one of the flags ORed together when using the NWDSReadNDSInfo function.
Table 5-4 eDirectory Ping Input Values
|
Flag Name and C Value |
Data Type |
Meaning |
|---|---|---|
|
DSPING_SUPPORTED_FIELDS 0x00000001L |
nuint32 |
Specifies which requested fields of information are actually returned. If the server cannot provide one of the items requested by the DSPING flags, the server clears the corresponding bit in the Supported Fields flag. No matter which bits are set, the order of the returned data is the same as the requested order. |
|
DSPING_DEPTH 0x00000002L |
nuint32 |
Returns the number of levels down from the eDirectory tree’s root object to the server’s root-most entry. |
|
DSPING_BUILD_NUMBER 0x00000004L |
nuint32 |
Returns the internal NDS/eDirectory version number. |
|
DSPING_FLAGS 0x00000008L |
nuint32 |
See Table 5-5. |
|
DSPING_VERIFICATION_FLAGS 0x00000010L |
nuint32 |
See Table 5-6. |
|
DSPING_LETTER_VERSION 0x00000020L |
nuint32 |
Returns the internal eDirectory letter that may accompany the NDS/eDirectory version number. |
|
DSPING_OS_VERSION 0x00000040L |
NDSOSVersion_T structure |
Returns three nuint32 values; the first is the major version number of the operating system; the second, the minor version number; the third, the revision number. |
|
DSPING_TIMESYNC_STATE 0x00000080L |
|
Not used. |
|
DSPING_LICENSE_FLAGS 0x00000100L |
nuint32 |
Not used; always returns zero (0). |
|
DSPING_DS_TIME 0x00000200L |
nuint32 |
Returns the current UTC time of the server (number of seconds since January 1, 1970). |
|
DSPING_SAP_NAME 0x00010000L |
NULL terminated string |
Returns the name the eDirectory server is using for SAP protocol. |
|
DSPING_TREE_NAME 0x00020000L |
NULL terminated string |
Returns the name of the eDirectory tree the server belongs to. |
|
DSPING_OS_NAME 0x00040000L |
NULL terminated string |
Returns the name of the operating system which eDirectory is running on top of. |
|
DSPING_HARDWARE_NAME 0x00080000L |
NULL terminated string |
Returns the hardware of the server’s machine (for example, PC compatible). |
|
DSPING_VENDOR_NAME 0x00100000L |
NULL terminated string |
Returns the name of the company that produced this version of the eDirectory server. Usually, Novell, Inc. |
The DSPING_FLAGS can be ORed together.
Table 5-5 DSPING_FLAGS Values
The DSPING_VERIFICATION_FLAGS can be ORed together.