MprAdminGetPDCServer 関数 (mprapi.h)
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。
関数が失敗した場合、戻り値は次のいずれかの値になります。
| 値 | 意味 |
|---|---|
|
指定されたドメインが無効です。 |
|
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 |