NetUserValidate2 or Net32UserValidate2

The NetUserValidate2 API validates a user ID with its password, and checks whether there are any logon restrictions for this user account. If the specified user account is not found, this API attempts to validate the guest account, instead. If this happens, all verification checks will be based only on the guest account. If the call completes successfully, a user_logon_info_1 structure is returned in the same input buffer and the code is set appropriately.

The NetUserValidate2 API replaces the NetUserValidate API, which is now obsolete.

Restrictions

LAN Server and OS/2 Warp Server Only

This API can be called only from an OS/2 workstation.

#include <netcons.h>
#include <access.h>
#include <lsdceerr.h>    /* DSS only */
 
NetUserValidate2(pszTarget, sLevel, buf,
                usBuflen, reserved2, pusBytesAvail);    /* 16 bit */
 
Net32UserValidate2(pszTarget, ulLevel, buf,
                ulBuflen, reserved2, pulBytesAvail,
                pStatusbuf);                             /* 32 bit */

See Common Parameter Definitions for descriptions of parameters not defined here.

sLevel or ulLevel

Note: When an application issues the NetUserValidate2 call, it passes a user_logon_req_1 data structure, described in User Logon Request Level 1. The returned data structure, however, is user_logon_info_1, described in User Logon Level 1.

reserved2

(16-bit unsigned short or 32-bit unsigned long) must be 0.

The following table lists the return codes most significant to this API. (See API Return Codes for a complete list of return codes.) кФФФФФФФФФФФФФФФФФФФФФФФФФФФФФТФФФФФФФТФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФПГSYMBOLICCONSTANT ГVALUEГMEANING Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_Success Г 0 Г No errors were encountered. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г ERROR_BAD_NETPATH Г 53 Г The network path cannot be found. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г ERROR_INVALID_PASSWORD Г 86 Г The specified password is not valid. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г ERROR_INVALID_LEVEL Г 124 Г The sLevel parameter is not valid. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г ERROR_MORE_DATA Г 234 Г Additional data is available, but the Г
Г Г Г buffer is too small. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_BufTooSmall Г 2123 Г The buffer is too small for fixed- Г
Г Г Г length data. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_ACFNotLoaded Г 2227 Г The UAS database has not been started. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_ACFFileIOFail Г 2229 Г An error was encountered in accessing Г
Г Г Г the accounts database. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_InvalidDatabase Г 2247 Г The UAS database file is damaged. Г
РФФФФФФФФФФФФФФФФФФФФФФФФФФФФФСФФФФФФФСФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФй

Other codes could be returned from the following functions:

DosAllocSeg
DosChgFilePtr
DosFsCtl
DosGetShrSeg
DosNewSize
DosQFileInfo
DosRead
DosWrite

[Back]

[Next]