RasAdminGetUserAccountServer 関数

  • [アーティクル]

[この関数は、Windows NT Server 4.0 との下位互換性のみを目的として提供されます。 Windows Server 2003 でERROR_CALL_NOT_IMPLEMENTEDを返します。 アプリケーションでは MprAdminGetPDCServer 関数を使用する必要があります。]

RasAdminGetUserAccountServer 関数は、ユーザー アカウント データベースを持つサーバーの名前を取得します。 RasAdminUserGetInfo 関数と RasAdminUserSetInfo 関数で返されるサーバー名を使用して、指定したユーザーに関する情報を取得または設定します。

構文

DWORD RasAdminGetUserAccountServer(
  _In_  const WCHAR  *lpszDomain,
  _In_  const WCHAR  *lpszServer,
  _Out_       LPWSTR lpszUserAccountServer
);

パラメーター

lpszDomain [in]

RAS サーバーが属するドメインの名前を指定する null で終わる Unicode 文字列へのポインター。 ドメインのメンバーではないワークステーションまたはサーバーで実行されている RAS 管理アプリケーションの場合、このパラメーターは NULL です。 このパラメーターが NULL の場合、 lpszServer パラメーターは NULL 以外である必要があります。

lpszServer [in]

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

lpszUserAccountServer [out]

ユーザー アカウント データベースを持つドメイン コントローラーの名前を指定する null で終わる Unicode 文字列を受け取るバッファーへのポインター。 バッファーは、サーバー名 (UNCLEN +1) を保持するのに十分な大きさにする必要があります。 関数は、返されたサーバー名の先頭に "\\" 文字を付けます。形式は \\servername です。

戻り値

関数が成功した場合、戻り値は ERROR_SUCCESS です。

関数が失敗した場合、戻り値は次のエラー コードになります。

値 説明
ERROR_INVALID_PARAMETER
 lpszDomain と lpszServer はどちらも NULL です。

この関数の拡張エラー情報はありません。 GetLastError を呼び出さないでください。

解説

RasAdminGetUserAccountServer 関数は、ユーザー アカウント データベースを持つサーバーの名前を取得します。 この関数には、RAS サーバーの名前または RAS サーバーが存在するドメインの名前が必要です。

lpszDomain パラメーターには、有効なドメイン名を指定する必要があります。 このパラメーターは、ドメインのメンバーではないサーバーで実行されている RAS 管理アプリケーションの 場合は NULL です (たとえば、サーバーは独自のワークグループ内にあります)。 この場合、 lpszServer パラメーターはサーバー名を指定する必要があります。 サーバー名を取得するには、 GetComputerName 関数を呼び出します。 必ず、サーバー名の先頭に "\\" 文字を付けます。

lpszServer で指定されたサーバー名がスタンドアロン サーバー (つまり、サーバーまたはワークステーションがドメインのメンバーではない) である場合、サーバー名自体は lpszUserAccountServer バッファーで返されます。

次に、 NetQueryDisplayInformation 関数の呼び出しでユーザー アカウント サーバーの名前を使用して、ユーザー アカウント データベース内のユーザーを列挙します。

要件

要件 値
クライアント サポートの終了
 Windows 2000 Professional
サーバー サポートの終了
 Windows 2000 Server
ヘッダー
Rassapi.h
ライブラリ
Rassapi.lib
[DLL]
Rassapi.dll

関連項目

リモート アクセス サービス (RAS) の概要

RAS サーバー管理機能

GetComputerName

RasAdminUserGetInfo

RasAdminUserSetInfo