次の方法で共有


WTSSetListenerSecurityA 関数 (wtsapi32.h)

リモート デスクトップ サービス リスナーのセキュリティ記述子を構成します。

構文

BOOL WTSSetListenerSecurityA(
  [in] HANDLE               hServer,
  [in] PVOID                pReserved,
  [in] DWORD                Reserved,
  [in] LPSTR                pListenerName,
  [in] SECURITY_INFORMATION SecurityInformation,
  [in] PSECURITY_DESCRIPTOR pSecurityDescriptor
);

パラメーター

[in] hServer

RD セッション ホスト サーバーへのハンドル。 常にこのパラメーターを WTS_CURRENT_SERVER_HANDLEに設定します。

[in] pReserved

このパラメーターは予約されています。 このパラメーターは、常に NULL設定してください。

[in] Reserved

このパラメーターは予約されています。 このパラメーターは常に 0 に設定してください。

[in] pListenerName

リスナーの名前を含む null で終わる文字列へのポインター。

[in] SecurityInformation

設定するセキュリティ情報を指定する SECURITY_INFORMATION 値。 常に DACL_SECURITY_INFORMATION フラグと SACL_SECURITY_INFORMATION フラグを有効にします。

使用可能な値の詳細については、SECURITY_INFORMATIONを参照してください。

[in] pSecurityDescriptor

リスナーに関連付けられているセキュリティ情報を含む SECURITY_DESCRIPTOR 構造体へのポインター。 使用可能な値の詳細については、SECURITY_DESCRIPTORを参照してください。 STANDARD_RIGHTS_REQUIREDの詳細については、「Standard Access Rights」を参照してください。

セキュリティ記述子の随意アクセス制御リスト (DACL) には、次の値のうち 1 つ以上を含めることができます。

WTS_SECURITY_ALL_ACCESS

次の値を結合します。

  • STANDARD_RIGHTS_REQUIRED
  • WTS_SECURITY_CONNECT
  • WTS_SECURITY_DISCONNECT
  • WTS_SECURITY_LOGON
  • WTS_SECURITY_MESSAGE
  • WTS_SECURITY_QUERY_INFORMATION
  • WTS_SECURITY_REMOTE_CONTROL
  • WTS_SECURITY_RESET
  • WTS_SECURITY_SET_INFORMATION
  • WTS_SECURITY_VIRTUAL_CHANNELS

WTS_SECURITY_CONNECT (256 (0x100))

接続する権限。

WTS_SECURITY_CURRENT_GUEST_ACCESS

次の値を結合します。

  • WTS_SECURITY_LOGOFF
  • WTS_SECURITY_VIRTUAL_CHANNELS

WTS_SECURITY_CURRENT_USER_ACCESS

次の値を結合します。

  • WTS_SECURITY_DISCONNECT
  • WTS_SECURITY_LOGOFF
  • WTS_SECURITY_RESET
  • WTS_SECURITY_SET_INFORMATION
  • WTS_SECURITY_VIRTUAL_CHANNELS

WTS_SECURITY_DISCONNECT (512 (0x200))

切断する権限。

WTS_SECURITY_GUEST_ACCESS

WTS_SECURITY_LOGONとして定義されます。

WTS_SECURITY_LOGOFF (64 (0x40))

ログオフする権限。

WTS_SECURITY_LOGON (32 (0x20))

ログオンする権限。

WTS_SECURITY_MESSAGE (128 (0x80))

ユーザーにメッセージを送信する権限。

WTS_SECURITY_QUERY_INFORMATION (1 (0x1))

情報を照会する権限。

WTS_SECURITY_REMOTE_CONTROL (16 (0x10))

リモート コントロールを使用する権限。

WTS_SECURITY_RESET (4 (0x4))

情報をリセットする権限。

WTS_SECURITY_SET_INFORMATION (2 (0x2))

情報を設定する権限。

WTS_SECURITY_USER_ACCESS

次の値を結合します。

  • WTS_SECURITY_CONNECT
  • WTS_SECURITY_CURRENT_GUEST_ACCESS
  • WTS_SECURITY_QUERY_INFORMATION

WTS_SECURITY_VIRTUAL_CHANNELS (8 (0x8))

仮想チャネルを使用する権限。

戻り値

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

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

備考

手記

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

必要条件

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

関連項目

SECURITY_DESCRIPTOR

SECURITY_INFORMATION