WTSGetListenerSecurityW

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

WTSGetListenerSecurityW hServer, pReserved, Reserved, pListenerName, SecurityInformation, pSecurityDescriptor, nLength, lpnLengthNeeded

hServer : [intptr] RD セッションホストサーバーへのハンドル。常に WTS_CURRENT_SERVER_HANDLE に設定する。
pReserved : [intptr] このパラメータは予約されている。常に NULL に設定する。
Reserved : [int] このパラメータは予約されている。常に 0 に設定する。
pListenerName : [wstr] リスナー名を含む NULL 終端文字列へのポインタ。
SecurityInformation : [int] 取得するセキュリティ情報を指定する SECURITY_INFORMATION 値。DACL_SECURITY_INFORMATION と SACL_SECURITY_INFORMATION フラグを常に有効にする。
pSecurityDescriptor : [int] pListenerName が参照するリスナーに関連付けられたセキュリティ情報を受け取る SECURITY_DESCRIPTOR 構造体へのポインタ。構造体は自己相対形式で返される。
nLength : [int] pSecurityDescriptor が指す SECURITY_DESCRIPTOR 構造体のサイズ (バイト単位)。
lpnLengthNeeded : [var] 完全なセキュリティ記述子を格納するのに必要なバイト数を受け取る変数へのポインタ。nLength 以下なら pSecurityDescriptor が指す SECURITY_DESCRIPTOR 構造体にコピーされる。

(プラグイン / モジュール : wtsapi32.dll)

解説

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

[戻り値]
関数が成功すると戻り値は 0 以外となる。関数が失敗した場合、戻り値は 0 となる。拡張エラー情報を取得するには GetLastError
を呼び出す。

[備考]
必要なバッファサイズが不明な場合、nLength を 0 にして呼ぶと lpnLengthNeeded
に必要バイト数が返る。それに基づいてバッファを確保し、pSecurityDescriptor と nLength
を再設定してもう一度呼ぶ。
> [!NOTE] > wtsapi32.h は WTSGetListenerSecurity を ANSI/Unicode
自動選択エイリアスとして定義している。

情報