RtlSetOwnerSecurityDescriptor 関数 (ntifs.h)

[アーティクル]
03/08/2023

RtlSetOwnerSecurityDescriptor ルーチンは、絶対形式のセキュリティ記述子の所有者情報を設定します。セキュリティ記述子に既に存在するすべての所有者情報が置き換えられます。

構文

NTSYSAPI NTSTATUS RtlSetOwnerSecurityDescriptor(
  [in, out]      PSECURITY_DESCRIPTOR SecurityDescriptor,
  [in, optional] PSID                 Owner,
  [in, optional] BOOLEAN              OwnerDefaulted
);

パラメーター

[in, out] SecurityDescriptor

所有者が設定されるSECURITY_DESCRIPTOR構造体へのポインター。 RtlSetOwnerSecurityDescriptor は、既存の所有者を新しい所有者に置き換えます。

[in, optional] Owner

セキュリティ記述子の新しいプライマリ所有者のセキュリティ識別子 (SID) 構造体へのポインター。 SID 構造体自体ではなく、このポインターがセキュリティ記述子にコピーされます。このパラメーターが NULL の場合、 RtlSetOwnerSecurityDescriptor はセキュリティ記述子の所有者情報をクリアします。これにより、セキュリティ記述子に所有者がいないとマークされます。

[in, optional] OwnerDefaulted

所有者情報が既定のメカニズムから派生する場合は TRUE に 設定します。この値が TRUE の場合は、既定の情報です。 RtlSetOwnerSecurityDescriptor は、セキュリティ記述子の SECURITY_DESCRIPTOR_CONTROL フィールドにSE_OWNER_DEFAULTED フラグを設定します。このパラメーターが FALSE の場合、SE_OWNER_DEFAULTED フラグはクリアされます。

戻り値

RtlSetOwnerSecurityDescriptor は、次のいずれかの状態コードを返すことができます。

リターンコード	説明
STATUS_SUCCESS	所有者が正常に設定またはリセットされました。
STATUS_UNKNOWN_REVISION	指定されたセキュリティ記述子のバージョンは、このルーチンでは認識されません。
STATUS_INVALID_SECURITY_DESCR	指定されたセキュリティ記述子は、有効な絶対セキュリティ記述子ではありません。

注釈

セキュリティとアクセス制御の詳細については、ドライバー開発者向けの Windows セキュリティモデルと、Windows SDK のこれらのトピックに関するドキュメントを参照してください。

要件

要件	値
対象プラットフォーム	ユニバーサル
Header	ntifs.h (Ntifs.h を含む)
Library	NtosKrnl.lib
[DLL]	NtosKrnl.exe (カーネルモード);Ntdll.dll (ユーザーモード)
IRQL	< DISPATCH_LEVEL