NWVerifyObjectPassword

Verifies the password of a bindery object on the specified NetWare server

Local Servers:blocking
Remote Servers:blocking
NetWare Server:3.11, 3.12, 4.x, 5.x, 6.x
Platform:NLM, Windows NT, Windows 95, Windows 98
Library:Cross-Platform NetWare Calls (CAL*.*)
Service:Bindery

Syntax

C

   #include <nwbindry.h> 
   or 
   #include <nwcalls.h> 
    
   NWCCODE N_API  NWVerifyObjectPassword  ( 
      NWCONN_HANDLE       conn,  
      const nstr8 N_FAR  *objName,  
      nuint16             objType,  
      const nstr8 N_FAR  *password);
   

Pascal

   uses calwin32 
    
   Function NWVerifyObjectPassword 
     (conn : NWCONN_HANDLE; 
      const objName : pnstr8; 
      objType : nuint16; 
      const password : pnstr8 
   ) : NWCCODE; stdcall;
   

Parameters

conn
(IN) Specifies the NetWare server connection handle whose password is to be verified.
objName
(IN) Points to the name of the object whose password is to be verified.
objType
(IN) Specifies the type of object (see Object Type for type values).
password
(IN) Points to the password to be verified.

Return Values

These are common return values. See Return Values (Return Values for C).

0x0000

SUCCESSFUL

0x89F0

WILD_CARD_NOT_ALLOWED

0x89FB

INVALID_PARAMETERS

0x89FC

NO_SUCH_OBJECT

0x89FF

NO_SUCH_OBJECT_OR_BAD_PASSWORD

Remarks

The requesting workstation does not have to be logged in to the NetWare server to call NWVerifyObjectPassword.

If the server supports encrypted passwords, the password is encrypted. If the server does not support encryption, password verification is attempted without encryption.

The objName and objType parameters must uniquely identify the bindery object and cannot contain wildcards.

A bindery object without a PASSWORD is different from a bindery object with a PASSWORD having no value. A workstation is not allowed to log in to a NetWare server as a bindery object that does not have a PASSWORD. A workstation can log in without a password if the bindery object has been given a PASSWORD containing no value.

NCP Calls

See Also

NWLoginToFileServer (Server Management)