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 |