NWDSRestoreObject(3nw)
NWDSRestoreObject --
restores object attribute names and values
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
The parameters are as follows:
- 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
NWDSBackupObject(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.