次の方法で共有


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

関数が失敗した場合、戻り値は次のいずれかの値になります。

意味
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

こちらもご覧ください

GetComputerName

MprAdminUserGetInfo

MprAdminUserSetInfo

NetQueryDisplayInformation

RAS 管理関数

リモート アクセス サービス管理リファレンス