GetFileSecurityW

ファイルまたはディレクトリのセキュリティに関する指定された情報を取得する。取得できる情報は、呼び出し側のアクセス権と特権によって制約される。(GetFileSecurityW)

GetFileSecurityW lpFileName, RequestedInformation, pSecurityDescriptor, nLength, lpnLengthNeeded

lpFileName : [wstr] セキュリティ情報を取得するファイルまたはディレクトリを指定する null 終端文字列へのポインタ。
RequestedInformation : [int] 要求するセキュリティ情報を識別する SECURITY_INFORMATION 値。
pSecurityDescriptor : [int] lpFileName パラメータで指定されたオブジェクトのセキュリティ記述子のコピーを受け取るバッファへのポインタ。呼び出し元プロセスは、そのオブジェクトのセキュリティ状態の指定された側面を表示する権限を持っている必要がある。SECURITY_DESCRIPTOR 構造体は自己相対セキュリティ記述子形式で返される。
nLength : [int] pSecurityDescriptor パラメータが指すバッファのサイズ (バイト単位) を指定する。
lpnLengthNeeded : [var] 完全なセキュリティ記述子を格納するのに必要なバイト数を受け取る変数へのポインタ。返されたバイト数が nLength 以下の場合、セキュリティ記述子全体が出力バッファに返される。そうでない場合、記述子は返されない。

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

解説

ファイルまたはディレクトリのセキュリティに関する指定された情報を取得する。取得できる情報は、呼び出し側のアクセス権と特権によって制約される。(GetFileSecurityW)

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

[備考]
指定したファイルまたはディレクトリのセキュリティ記述子から所有者、グループ、または DACL
を読み取るには、そのファイルまたはディレクトリの DACL が呼び出し側に READ_CONTROL
アクセスを許可しているか、呼び出し側がファイルまたはディレクトリの所有者である必要がある。ファイルまたはディレクトリの SACL
を読み取るには、呼び出し元プロセスで SE_SECURITY_NAME 特権を有効にしなければならない。

情報