SetPrivateObjectSecurity 関数 (securitybaseapi.h)

[アーティクル]
03/01/2024

SetPrivateObjectSecurity 関数は、プライベートオブジェクトのセキュリティ記述子を変更します。

保護されたサーバーがアクセス制御エントリ (ACE) の自動継承をサポートするかどうかを指定するには、 SetPrivateObjectSecurityEx 関数を使用します。

構文

BOOL SetPrivateObjectSecurity(
  [in]           SECURITY_INFORMATION SecurityInformation,
  [in]           PSECURITY_DESCRIPTOR ModificationDescriptor,
  [in, out]      PSECURITY_DESCRIPTOR *ObjectsSecurityDescriptor,
  [in]           PGENERIC_MAPPING     GenericMapping,
  [in, optional] HANDLE               Token
);

パラメーター

[in] SecurityInformation

設定するセキュリティ記述子の部分を示します。この値は、SECURITY_INFORMATION ビットフラグの組み合わせです。

[in] ModificationDescriptor

SECURITY_DESCRIPTOR構造体へのポインター。 SecurityInformation パラメーターによって示されるこのセキュリティ記述子の部分は、ObjectsSecurityDescriptor セキュリティ記述子に適用されます。

[in, out] ObjectsSecurityDescriptor

SECURITY_DESCRIPTOR構造体へのポインターへのポインター。このセキュリティ記述子は、自己相対形式である必要があります。 セキュリティ記述子のメモリは、HeapAlloc 関数を使用してプロセスヒープ (GetProcessHeap) から割り当てる必要があります。

入力時に、これはプライベートオブジェクトの現在のセキュリティ記述子です。関数は、新しいセキュリティ記述子を生成するように変更します。必要に応じて、 SetPrivateObjectSecurity 関数は、より大きなセキュリティ記述子を生成するために追加のメモリを割り当てます。

[in] GenericMapping

各汎用アクセス権に対応する特定の標準アクセス権を指定する GENERIC_MAPPING構造体へのポインター。

[in, optional] Token

プライベートオブジェクトのセキュリティが変更されているクライアントのアクセストークンへのハンドル。このパラメーターは、クライアントが新しい所有者セキュリティ識別子 (SID) の正当な値を提供していることを確認するために必要です。 TOKEN_QUERYアクセスするには、トークンを開く必要があります。

戻り値

関数が成功した場合、関数は 0 以外の値を返します。

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

解説

この関数は、リソースマネージャーのみが使用することを目的としています。セキュリティ記述子を更新するための標準のアクセス制御セマンティクスを実装するには、リソースマネージャーは SetPrivateObjectSecurity を呼び出す前に、次の条件が満たされていることを確認する必要があります。

オブジェクトの所有者が設定されている場合、呼び出し元のプロセスには、WRITE_OWNERアクセス許可を持っているか、オブジェクトの所有者である必要があります。
オブジェクトの随意アクセス制御リスト (DACL) が設定されている場合、呼び出し元のプロセスには、WRITE_DACアクセス許可を持っているか、オブジェクトの所有者である必要があります。
オブジェクトのシステムアクセス制御リスト (SACL) が設定されている場合は、呼び出し元プロセスに対してSE_SECURITY_NAME特権を有効にする必要があります。

上記の条件が満たされていない場合、この関数の呼び出しは失敗しません。ただし、標準アクセスポリシーは適用されません。

クライアントには通常、基になるトークン操作に必要な適切な特権がないため、この関数を呼び出すプロセスはクライアントを偽装しないでください。

要件

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