wntRasUserGet

Gets RAS information for a user.

Syntax:

wntRasUserGet( server-name, user-name, request [, input-format-flag])

Parameters:

(s) server-name: is the UNC name of the primary or backup domain controller that has the user account database (eg, "\\MYSERVER"). If the machine on which the user account resides is a standalone NT workstation or server, you can specify the UNC name of that machine, or "" for the local computer.

(s) user-name: is the name of a user.

(i) request: specifies the information to be returned, and can be one of the following:
1 - Dial-in privilege or
2 - Callback phone number

(i) input-format-flag: [optional] controls how the user-name parameter value is interpreted.

Value Meaning
0 (default) user-name is actual user acount name
1 user-name contains a SID value instead of an actual user account name.

Returns:

(i/s) Value Returns one of the following, depending on the request.

1

(i) Dial-in privilege

2

(s) Callback phone number

"Privilege"

Dial-in privilege specifies both the dial-in permission and the callback mode, and will be one of the following values:

 

Value

Meaning

1

No dial-in permission / No callback privilege

2

No dial-in permission / Callback number preset by administratorr

4

No dial-in permission / Callback number specified by caller

9

Dial-in permission / No callback privilege

10

Dial-in permission / Callback number preset by administrator

12

Dial-in permission / Callback number specified

 

Note: wntRasUserGet and wntRasUserSet require RASSAPI.DLL.

 

Example:
; Load Appropriate Extender
AddExtender('wwwnt34i.dll',0,'wwwnt64i.dll')


flags=wntRasUserGet("\\SERV","user1",1,0)
Message("RASFlags on User1", flags)


wntRasUserSet("\\SERV","user1","9","",0)
flags=wntRasUserGet("\\SERV","user1",1,0)
Message("RASFlags on User1", flags)


Exit
See Also:

wntRasUserSet