NWDSInspectEntry

Inspects an object for correctness.

Local Servers:blocking
Remote Servers:blocking
NetWare Server:4.x, 5.x, 6.x
Platform:NLM, Windows NT, Windows 95, Windows 98, Windows 2000, Windows XP
Library:Cross-Platform NDS (NET*.*)
Service:NDS

Syntax

C

  #include <nwnet.h> 
  or 
  #include <nwdsdsa.h> 
   
  N_EXTERN_LIBRARY (NWDSCCODE)  NWDSInspectEntry  ( 
     NWDSContextHandle   context,  
     pnstr8              serverName,  
     pnstr8              objectName,  
     pBuf_T              errBuffer);

Pascal

  uses netwin32 
   
  Function NWDSInspectEntry 
    (context : NWDSContextHandle; 
     serverName : pnstr8; 
     objectName : pnstr8; 
     errBuffer : pBuf_T 
  ) : NWDSCCODE;

Parameters

context

(IN) Specifies the NDS context for the request.

serverName

(IN) Points to the server name to which to connect.

objectName

(IN) Points to the object name to be inspected.

errBuffer

(OUT) Points to the Buf_T structure which is a result buffer containing the requested information.

Return Values

0x0000 0000

SUCCESSFUL

nonzero value

Nonzero values indicate errors. See NDS Return Values (–001 to –799).

Remarks

NWDSInspectEntry is a diagnostic function allowing you to inspect an object in the replica on a specific server to see if the object needs to be repaired.

If no partition exists on the server specified by serverName or the object does not exist in the partition(s) on the specified server, NWDSInspectEntry returns ERR_NO_SUCH_ENTRY.

After successful completion of this function call, the output buffer contains the following data:

Return Code

nuint

Success

Entry Size

nuint

Total number of bytes occupied by the entry’s base record and its attribute values

Error Count

nuint

Number of errors found in the entry record on that server

Error Reports

nuint

List of error codes indicating errors in the entry record

NCP Calls