SetSecurityDescriptorOwner 関数 (securitybaseapi.h)

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

構文

BOOL SetSecurityDescriptorOwner(
  [in, out]      PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [in, optional] PSID                 pOwner,
  [in]           BOOL                 bOwnerDefaulted
);

パラメーター

[in, out] pSecurityDescriptor

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

[in, optional] pOwner

セキュリティ記述子の新しいプライマリ所有者の SID 構造へのポインター。 SID 構造体は、セキュリティ記述子によって参照され、コピーされません。 このパラメーターが NULL の場合、この関数はセキュリティ記述子の所有者情報をクリアします。 これにより、セキュリティ記述子に所有者がいないとマークされます。

[in] bOwnerDefaulted

所有者情報が既定のメカニズムから派生したものかどうかを示します。 この値が TRUE の場合は、既定の情報です。 関数は、この値を SE_OWNER_DEFAULTED フラグとして SECURITY_DESCRIPTOR_CONTROL 構造体に格納します。 このパラメーターが 0 の場合は、SE_OWNER_DEFAULTED フラグがクリアされます。

戻り値

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。

要件

   
サポートされている最小のクライアント Windows XP [デスクトップ アプリ | UWP アプリ]
サポートされている最小のサーバー Windows Server 2003 [デスクトップ アプリのみ | UWP アプリ]
対象プラットフォーム Windows
ヘッダー securitybaseapi.h (Windows.h を含む)
Library Advapi32.lib
[DLL] Advapi32.dll

関連項目

GetSecurityDescriptorOwner

InitializeSecurityDescriptor

IsValidSecurityDescriptor

低レベルのAccess Control

低レベルのAccess Control関数

SECURITY_DESCRIPTOR

SECURITY_DESCRIPTOR_CONTROL

SID

SetSecurityDescriptorDacl

SetSecurityDescriptorGroup

SetSecurityDescriptorSacl