NWDSRestoreObject(3nw)

Synopsis

   #include <nwnet.h> 
   or 
   #include <nwdsdsa.h> 
   
 
   NWDSCCODE N_API NWDSRestoreObject 
     (NWDSContextHandle   context, 
      pnstr8              objectName, 
      pnint32             iterationHandle, 
      nbool8              more, 
      nuint32             size, 
      pnuint8             objectInfo); 

Description

context

(IN) Specifies the Directory context for the request.

objectName

(IN) Points to the object name for which information is to be returned.

more

(IN) Specifies a partial message.

size

(IN) Specifies the length of the information to be restored.

objectInfo

(IN) Points to the starting location of the information to be restored.

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

NWDSRestoreObject is used to restore the attributes and attribute values for one object at a time. To restore the entire directory, NWDSRestoreObject must be called for each object that is to be restored into the directory.

iterationHandle and more are used to control the restoring of an object's information which cannot be restored with one call to NWDSRestoreObject. If more information will be coming after the current call, more should be set to TRUE. Otherwise, it should be set to FALSE. In the initial call to NWDSRestoreObject, iterationHandle should point to NWDS_ITERATION which has been set to NO_MORE_ITERATIONS.

After calling NWDSRestoreObject for the last time, and setting more to FALSE, the value pointed to by iterationHandle will be set to NO_MORE_ITERATIONS on return.

size specifies the length of the information pointed to by objectInfo. This is the information saved after calling NWDSBackupObject.

Services

Directory

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