[This function is provided only for backward compatibility with Windows NT Server 4.0. It returns ERROR_CALL_NOT_IMPLEMENTED on Windows Server 2003. Applications should use the MprAdminUserSetInfo function.]
The RasAdminUserSetInfo function sets the RAS permissions and call-back phone number for a specified user.
Syntax
DWORD RasAdminUserSetInfo(
_In_ const WCHAR *lpszUserAccountServer,
_In_ const WCHAR *lpszUser,
_In_ const PRAS_USER_0 pRasUser0
);
Parameters
lpszUserAccountServer [in]
Pointer to a null-terminated Unicode string that specifies the name of the primary or backup domain controller that has the user account database. Use the RasAdminGetUserAccountServer function to get this server name.
lpszUser [in]
Pointer to a null-terminated Unicode string that specifies the name of the user for whom RAS information is to be set.
pRasUser0 [in]
Pointer to the RAS_USER_0 structure that specifies the new RAS data for the specified user.
Return value
If the function succeeds, the return value is ERROR_SUCCESS.
If the function fails, the return value can be one of the following error codes.
| Value | Description |
|---|---|
| ERROR_INVALID_DATA | The pRasUser0 buffer contains invalid data. |
| ERROR_INVALID_CALLBACK_NUMBER | The callback number specified in the pRasUser0 buffer contains invalid characters. |
| NERR_BufTooSmall | Insufficient memory to perform this function. |
There is no extended error information for this function; do not call GetLastError.
Remarks
When setting the RAS permissions for a user, the bfPrivilege member of the RAS_USER_0 structure must specify at least one of the call-back flags. For example, to set a user's privileges to allow dial-in privilege but no call-back privilege, set bfPrivilege to RASPRIV_DialinPrivilege | RASPRIV_NoCallback.
Requirements
| Requirement | Value |
|---|---|
| End of client support | Windows 2000 Professional |
| End of server support | Windows 2000 Server |
| Header | Rassapi.h |
| Library | Rassapi.lib |
| DLL | Rassapi.dll |
See also
Remote Access Service (RAS) Overview
RAS Server Administration Functions
Source: Microsoft Learn / Windows Win32 documentation by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.
