次の方法で共有

WTSGetListenerSecurityA 関数 (wtsapi32.h)

  • [アーティクル]

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

構文

BOOL WTSGetListenerSecurityA(
  [in]            HANDLE               hServer,
  [in]            PVOID                pReserved,
  [in]            DWORD                Reserved,
  [in]            LPSTR                pListenerName,
  [in]            SECURITY_INFORMATION SecurityInformation,
  [out, optional] PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [in]            DWORD                nLength,
  [out]           LPDWORD              lpnLengthNeeded
);

パラメーター

[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」を参照してください。

[out, optional] pSecurityDescriptor

pListenerName パラメーターによって参照されるリスナーに関連付けられたセキュリティ情報を受け取るSECURITY_DESCRIPTOR構造体へのポインター。 SECURITY_DESCRIPTOR構造体は自己相対形式で返されます。 使用可能な値の詳細については、「 SECURITY_DESCRIPTOR」を参照してください。

セキュリティ記述子の随意アクセス制御リスト (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))

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

[in] nLength

pSecurityDescriptor パラメーターによって参照されるSECURITY_DESCRIPTOR構造体のサイズ (バイト単位)。

[out] lpnLengthNeeded

完全なセキュリティ記述子を格納するために必要なバイト数を受け取る変数へのポインター。 この数値が nLength パラメーターの値以下の場合、セキュリティ記述子は pSecurityDescriptor パラメーターによって参照されるSECURITY_DESCRIPTOR構造体にコピーされます。それ以外の場合、アクションは実行されません。

戻り値

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

関数が失敗した場合は、0 を返します。 エラーの詳細情報を得るには、GetLastError 関数を呼び出します。

注釈

SECURITY_DESCRIPTOR構造体を受け取るバッファーに必要なバイト数が不明な場合は、nLength を 0 に設定してこのメソッドを呼び出すことができます。 その後、 メソッドは lpnLengthNeeded パラメーターでバッファーに必要なバイト数を返します。 この番号に基づいてバッファーを割り当て、メソッドをもう一度呼び出し、 pSecurityDescriptor を新しく割り当てられたバッファーに、 nLength を最初の呼び出しによって返される番号に設定します。

注意

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

要件

要件 値
サポートされている最小のクライアント Windows 7
サポートされている最小のサーバー Windows Server 2008 R2
対象プラットフォーム Windows
ヘッダー wtsapi32.h
Library Wtsapi32.lib
[DLL] Wtsapi32.dll

関連項目

SECURITY_DESCRIPTOR

SECURITY_INFORMATION