次の方法で共有

WTSQueryUserConfigA 関数 (wtsapi32.h)

  • [アーティクル]

指定したドメイン コントローラーまたはリモート デスクトップ セッション ホスト (RD セッション ホスト) サーバー上の指定されたユーザーの構成情報を取得します。

構文

BOOL WTSQueryUserConfigA(
  [in]  LPSTR            pServerName,
  [in]  LPSTR            pUserName,
  [in]  WTS_CONFIG_CLASS WTSConfigClass,
  [out] LPSTR            *ppBuffer,
  [out] DWORD            *pBytesReturned
);

パラメーター

[in] pServerName

ドメイン コントローラーまたは RD セッション ホスト サーバーの名前を含む null で終わる文字列へのポインター。 アプリケーションが実行されている RD セッション ホスト サーバーを示す WTS_CURRENT_SERVER_NAME を指定します。

[in] pUserName

クエリするユーザー名を含む null で終わる文字列へのポインター。 RD セッション ホスト サーバーの既定のユーザー設定を取得するには、このパラメーターを NULLに設定します。

Windows Server 2008 および Windows Vista: このパラメーターを null に設定すると、エラーが返されます。

[in] WTSConfigClass

取得する情報の種類を指定します。 このパラメーターには、WTS_CONFIG_CLASS 列挙型の値のいずれかを指定できます。 WTS_CONFIG_CLASS のドキュメントでは、各情報の種類について ppBuffer 返されるデータの形式について説明します。

[out] ppBuffer

要求された情報へのポインターを受け取る変数へのポインター。 データの形式と内容は、WTSConfigClass パラメーターで指定された情報クラスによって異なります。 返されたバッファーを解放するには、WTSFreeMemory 関数を呼び出します。

[out] pBytesReturned

ppBufferで返されるデータのサイズをバイト単位で受け取る変数 ポインター。

戻り値

関数が成功した場合、戻り値は 0 以外の値になります。

関数が失敗した場合、戻り値は 0 です。 拡張エラー情報を取得するには、GetLastError呼び出します。

備考

WTSQueryUserConfig 関数と WTSSetUserConfig 関数 は、ユーザー アカウント情報がドメイン コントローラー上に存在することが多いため、ハンドルの代わりにサーバー名が渡されます。 ユーザー構成情報を設定するには、プライマリ ドメイン コントローラーを使用します。 NetGetDCName 関数を呼び出して、プライマリ ドメイン コントローラーの名前を取得できます。 ユーザー構成情報を照会するには、NetGetAnyDCName 関数を使用して、プライマリ ドメイン コントローラーまたはバックアップ ドメイン コントローラーの名前を取得します。

どのドメイン コントローラーでも、ユーザー構成情報を設定または照会できます。 ドメイン コントローラーの名前を取得するには、DsGetDcName 関数を使用します。

手記

wtsapi32.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして WTSQueryUserConfig を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows Vista
サポートされる最小サーバー Windows Server 2008
ターゲット プラットフォーム の ウィンドウズ
ヘッダー wtsapi32.h
ライブラリ Wtsapi32.lib
DLL Wtsapi32.dll

関連項目

WTSFreeMemory を する

WTSSetUserConfig の

WTS_CONFIG_CLASS