次の方法で共有

WTSSetUserConfigA 関数 (wtsapi32.h)

  • [アーティクル]

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

構文

BOOL WTSSetUserConfigA(
  [in] LPSTR            pServerName,
  [in] LPSTR            pUserName,
  [in] WTS_CONFIG_CLASS WTSConfigClass,
  [in] LPSTR            pBuffer,
  [in] DWORD            DataLength
);

パラメーター

[in] pServerName

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

[in] pUserName

構成が設定されているユーザーの名前を含む null で終わる文字列へのポインター。

[in] WTSConfigClass

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

[in] pBuffer

指定したユーザーの構成を変更するために使用するデータへのポインター。

[in] DataLength

pBuffer バッファーのサイズ (TCHAR)。

戻り値

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

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

備考

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

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

WTSConfigClass パラメーターの値が WTS_CONFIG_CLASS 列挙の整数値に対応する場合は、DWORDとして設定する値を定義します。 次の例に示すように、WTSSetUserConfigの呼び出しで値を LPWSTR キャストします。

WTSSetUserConfig( strServer.GetBuffer(0), 
                  m_strName.GetBuffer(0), 
                  WTSUserConfigfAllowLogonTerminalServer, 
                  (LPWSTR) &dwEnable, 
                  sizeof(DWORD));

手記

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

必要条件

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

関連項目

WTSQueryUserConfig の

WTS_CONFIG_CLASS