次の方法で共有

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
対象プラットフォーム Windows
ヘッダー wtsapi32.h
Library Wtsapi32.lib
[DLL] Wtsapi32.dll

関連項目

SECURITY_DESCRIPTOR

SECURITY_INFORMATION