Функция RasAdminGetUserAccountServer
[Эта функция предоставляется только для обеспечения обратной совместимости с Windows NT Server 4.0. Он возвращает ERROR_CALL_NOT_IMPLEMENTED в Windows Server 2003. Приложения должны использовать функцию MprAdminGetPDCServer .]
Функция RasAdminGetUserAccountServer извлекает имя сервера, на котором есть база данных учетной записи пользователя. Используйте возвращенное имя сервера в функциях RasAdminUserGetInfo и RasAdminUserSetInfo , чтобы получить или задать сведения об указанном пользователе.
Синтаксис
DWORD RasAdminGetUserAccountServer(
_In_ const WCHAR *lpszDomain,
_In_ const WCHAR *lpszServer,
_Out_ LPWSTR lpszUserAccountServer
);
Параметры
-
lpszDomain [in]
-
Указатель на строку Юникода с пустым завершением, указывающую имя домена, к которому принадлежит сервер RAS. Этот параметр имеет значение NULL для приложений администрирования RAS, работающих на рабочих станциях или серверах, которые не являются членами домена. Если этот параметр имеет значение NULL, параметр lpszServer должен иметь значение, отличное от NULL.
-
lpszServer [in]
-
Указатель на строку Юникода с пустым завершением, указывающую имя сервера RAS. Укажите имя с символами "\\" в формате \\servername. Этот параметр может иметь значение NULL , если параметр lpszDomain не равен NULL.
-
lpszUserAccountServer [out]
-
Указатель на буфер, получающий строку Юникода, завершающуюся null, которая указывает имя контроллера домена с базой данных учетной записи пользователя. Буфер должен быть достаточно большим, чтобы вместить имя сервера (UNCLEN +1). Функция префиксирует возвращенное имя сервера символами "\\" в виде \\servername.
Возвращаемое значение
Если функция выполнена успешно, возвращаемое значение будет ERROR_SUCCESS.
Если функция завершается сбоем, возвращаемым значением может быть следующий код ошибки.
| Значение | Значение |
|---|---|
|
И lpszDomain , и lpszServer имеют значение NULL. |
Для этой функции нет расширенных сведений об ошибке; не вызывать GetLastError.
Комментарии
Функция RasAdminGetUserAccountServer получает имя сервера с базой данных учетных записей пользователей. Для этой функции требуется имя сервера RAS или имя домена, в котором находится сервер RAS.
Параметр lpszDomain должен указывать допустимое доменное имя. Этот параметр имеет значение NULL для приложений администрирования RAS, работающих на серверах, которые не являются членами домена (например, сервер находится в собственной рабочей группе). В этом случае параметр lpszServer должен указывать имя сервера. Чтобы получить имя сервера, вызовите функцию GetComputerName . Обязательно добавьте к имени сервера символы "\\".
Если имя сервера, указанное lpszServer , является автономным сервером (то есть сервер или рабочая станция не является членом домена), то само имя сервера возвращается в буфере lpszUserAccountServer .
Затем используйте имя сервера учетных записей пользователей в вызове функции NetQueryDisplayInformation для перечисления пользователей в базе данных учетных записей пользователей.
Требования
| Требование | Значение |
|---|---|
| Окончание поддержки клиентов |
Windows 2000 Professional |
| Прекращение поддержки сервера |
Windows 2000 Server |
| Заголовок |
|
| Библиотека |
|
| DLL |
|