NetUserGetLogonAsn or Net32UserGetLogonAsn

The NetUserGetLogonAsn API retrieves information about logon assignments for a user.

Restrictions

LAN Server and OS/2 Warp Server Only

This API can be called from DLS and OS/2 workstations, but DLS workstations can issue this call only to a remote LAN Server workstation.

For NetUserGetLogonAsn to run successfully, one of the following must be true:

The calling process has Administrator authority.
The calling process has accounts operator privilege.
The calling process has User authority and is getting information about the logged-on user's logon assignments.

Domain control database subdirectories and files must exist for the user before NetUserGetLogonAsn is called. You can use the NetUserDCDBInit API to create the subdirectories and files.

Directory and Security Server Only

Any user with r permission can use level 1 and 200. Non-DSS instances of logon_asn extended registry attributes (ERA) are ignored and not returned in the logon assignment list. The format of the ERA allows for the possibility of non-DSS logon assignments.

Level 200 returns all of the users logon assignments regardless of what resource domain they are in.

#include <netcons.h>#include <dcdb.h>
#include <lsdceerr.h>       /* DSS only */
 
NetUserGetLogonAsn(pszTarget, pszUserID, usLevel, ResourceType,
                      buf, usBuflen, pusBytesAvail);    /* 16 bit */
 
Net32UserGetLogonAsn(pszTarget, pszUserID, ulLevel, ResourceType,
                      buf, ulBuflen, pulBytesAvail,
                      pStatusbuf);                      /* 32 bit */

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

sLevel or ulLevel

Logon Assignment Data Structure

ResourceType

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 Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г ERROR_PATH_NOT_FOUND Г 3 Г The path was not found. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г ERROR_TOO_MANY_OPEN_FILES Г 4 Г The maximum number of open files was Г
Г Г Г exceeded. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г ERROR_ACCESS_DENIED Г 5 Г Administrator privilege is required. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г ERROR_NOT_ENOUGH_MEMORY Г 8 Г Sufficient memory is not available. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г ERROR_INVALID_PARAMETER Г 87 Г At least one parameter value is not Г
Г Г Г valid. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г ERROR_INVALID_LEVEL Г 124 Г The ul/usLevel parameter is not valid. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г ERROR_MORE_DATA Г 234 Г Additional data is available, but the Г
Г Г Г buffer is too small. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_NetNotStarted Г 2102 Г The redirector NETWKSTA.200 has not Г
Г Г Г been started. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_BufTooSmall Г 2123 Г The buffer is too small for fixed- Г
Г Г Г length data. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_InvalidAPI Г 2142 Г The requested API is not supported on Г
Г Г Г the remote server. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_UserNotFound Г 2221 Г The user name cannot be found. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_DCDBError Г 2786 Г A domain control database file is Г
Г Г Г unreadable or cannot be accessed at Г
Г Г Г this time. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_NotPrimaryDCDB Г 2795 Г An attempt was made to access a domain Г
Г Г Г control database file on a machine Г
Г Г Г that is not the domain controller. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_DCEError Г 7500 Г DCE error status returned. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_DCEErrorLogged Г 7501 Г DCE error status has been logged. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_AuthTicketExpired Г 7511 Г The user's DCE authorization ticket Г
Г Г Г has expired. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_RegistryNotFound Г 7512 Г Unable to contact the DCE security Г
Г Г Г registry. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_UserNotInResdom Г 7513 Г The user is not a member of the speci- Г
Г Г Г fied resource domain. Г
РФФФФФФФФФФФФФФФФФФФФФФФФФФФФФСФФФФФФФСФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФй

Other codes could be returned from the following functions:

DosLoadModule
DosGetProcAddr

NetUserLogonAsn returns a buffer that points to a logon_asn_info_1 or logon_asn_info_200 structure. The structure element lai1_count or lai200_count indicates the number of logon_asn_list or logon_asn_list_200 structures that immediately follow the logon_asn_info_1 or logon_asn_info_200 structure in the buffer. lai1_count or lai200_count also indicates the number of the user's logon assignments of specified types.

LAN Server and OS/2 Warp Server Only

You can assume a user's domain control database (DCDB) area has not been initialized if NetUserGetLogonAsn is called and the ERROR_PATH_NOT_FOUND code is returned.

This call is equivalent functionally to an Enum call.

For information about:

Initializing the domain control database for a particular user, see User - NetUserDCDBInit.
Changing a particular user's logon assignments, see User - NetUserSetLogonAsn.
Retrieving information about a particular alias definition, see Alias - NetAliasGetInfo.
Listing alias definitions, see Alias - NetAliasEnum.
Creating an alias definition, see Alias - NetAliasAdd.

[Back]

[Next]