GetPrivateObjectSecurity

プライベート オブジェクトのセキュリティ記述子から情報を取得する。

GetPrivateObjectSecurity ObjectDescriptor, SecurityInformation, ResultantDescriptor, DescriptorLength, ReturnLength

ObjectDescriptor : [int] SECURITY_DESCRIPTOR 構造体へのポインタ。これはクエリ対象のセキュリティ記述子である。
SecurityInformation : [int] 取得するセキュリティ記述子の部分を示すビット フラグのセット。このパラメータは SECURITY_INFORMATION ビット フラグの組み合わせを指定できる。
ResultantDescriptor : [int] 指定したセキュリティ記述子から要求された情報のコピーを受け取るバッファへのポインタ。SECURITY_DESCRIPTOR 構造体は自己相対形式で返される。
DescriptorLength : [int] ResultantDescriptor パラメータが指すバッファのサイズ (バイト単位) を指定する。
ReturnLength : [var] 記述子が正常にコピーされた場合、関数はこの変数にゼロを設定する。バッファがセキュリティ記述子に対して小さすぎる場合、この変数には必要なバイト数が格納される。関数が戻るときにこの変数の値が DescriptorLength パラメータの値より大きい場合、関数は FALSE を返し、セキュリティ記述子はバッファにコピーされない。

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

解説

プライベート オブジェクトのセキュリティ記述子から情報を取得する。

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

[備考]
この関数はリソース
マネージャでのみ使用されることを意図している。セキュリティ記述子を更新する標準のアクセス制御セマンティクスを実装するために、リソース
マネージャは GetPrivateObjectSecurity を呼び出す前に、次の条件が満たされていることを確認すべきである。
（以下省略）

情報