MprAdminGetPDCServer 関数 (mprapi.h)

[アーティクル]
08/24/2023

MprAdminGetPDCServer 関数は、ドメイン名またはサーバー名から、マスターユーザーアカウントサブシステム (UAS) を持つサーバーの名前を取得します。ドメイン名パラメーターまたはサーバー名パラメーターは NULL でもかまいませんが、両方を指定することはできません。

構文

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

パラメーター

[in] lpszDomain

RAS サーバーが属するドメインの名前を指定する null で終わる Unicode 文字列へのポインター。ドメインに参加していないWindows NT/Windows 2000 サーバーで RAS 管理アプリケーションを実行している場合、このパラメーターは NULL にすることができます。このパラメーターが NULL の場合、 lpwsServerName パラメーターは NULL にすることはできません。

[in] lpszServer

Windows NT/Windows 2000 RAS サーバーの名前を指定する null で終わる Unicode 文字列へのポインター。先頭に "\" 文字を付け、 \servername という形式で名前を指定します。 lpwsDomain パラメーターが NULL でない場合、このパラメーターは NULL にすることができます。

[out] lpszPDCServer

ユーザーアカウントデータベースを持つドメインコントローラーの名前を含む null で終わる Unicode 文字列を受け取るバッファーへのポインター。バッファーは、サーバー名 (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
ヘッダー	mprapi.h
Library	Mprapi.lib
[DLL]	Mprapi.dll