次の方法で共有

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 を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

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

関連項目

SECURITY_DESCRIPTOR

SECURITY_INFORMATION