Функция MprAdminGetPDCServer (mprapi.h)

Статья
02/29/2024

Функция MprAdminGetPDCServer извлекает имя сервера с подсистемой master учетных записей пользователей (UAS) из доменного имени или имени сервера. Параметр доменного имени или параметр имени сервера может иметь значение NULL, но не оба.

Синтаксис

DWORD MprAdminGetPDCServer(
  [in]  LPCWSTR lpszDomain,
  [in]  LPCWSTR lpszServer,
  [out] LPWSTR  lpszPDCServer
);

Параметры

[in] lpszDomain

Указатель на строку Юникода с пустым завершением, указывающую имя домена, к которому принадлежит сервер RAS. Этот параметр может иметь значение NULL, если вы запускаете приложение администрирования RAS на сервере Windows NT или Windows 2000, который не участвует в домене. Если этот параметр имеет значение NULL, параметр lpwsServerName не должен иметь значение NULL.

[in] lpszServer

Указатель на строку Юникода с пустым завершением, указывающую имя сервера RAS Windows NT или Windows 2000. Укажите имя с символами "\" в формате \servername. Этот параметр может иметь значение NULL , если параметр lpwsDomain не равен NULL.

[out] lpszPDCServer

Указатель на буфер, который получает строку Юникода, завершающуюся null, которая содержит имя контроллера домена с базой данных учетной записи пользователя. Буфер должен быть достаточно большим, чтобы вместить имя сервера (UNCLEN +1). Функция префиксирует возвращенное имя сервера символами "\" в форме \servername.

Возвращаемое значение

Если функция выполнена успешно, возвращаемое значение будет NO_ERROR.

Если функция завершается сбоем, возвращается одно из следующих значений.

Значение	Значение
ERROR_NO_SUCH_DOMAIN	Указанный домен недопустим.
NERR_InvalidComputer	Параметр lpwsDomainName имеет значение NULL, а параметр lpwsServerName недопустим.

Функция MprAdminGetPDCServer может получить имя сервера с базой данных учетных записей пользователей, заданное именем сервера RAS или именем домена, в котором находится сервер RAS. Чтобы получить имя сервера, вызовите функцию GetComputerName .

Если имя сервера, указанное lpszServer , является частью домена, сервер, возвращенный MprAdminGetPDCServer , будет либо основным, либо резервным контроллером домена.

Если имя сервера, указанное в lpszServer, является автономным сервером Windows NT/Windows 2000 (то есть сервер или рабочая станция не участвуют в домене), то само имя сервера возвращается в буфере lpszUserAccountServer.

Затем можно использовать имя сервера учетных записей пользователей в вызове функции NetQueryDisplayInformation для перечисления пользователей в базе данных учетных записей пользователей. Имя сервера можно также использовать в вызовах функций MprAdminUserGetInfo и MprAdminUserSetInfo , чтобы получить и задать привилегии RAS для указанной учетной записи пользователя.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	mprapi.h
Библиотека	Mprapi.lib
DLL	Mprapi.dll