Share via

SetSecurityDescriptorControl 関数 (securitybaseapi.h)

  • [アーティクル]

SetSecurityDescriptorControl 関数は、セキュリティ記述子の制御ビットを設定します。 関数は、ACE の自動継承に関連する制御ビットのみを設定できます。 セキュリティ記述子の他の制御ビットを設定するには、 SetSecurityDescriptorDacl などの関数を使用して、セキュリティ記述子のコンポーネントを変更します。

構文

BOOL SetSecurityDescriptorControl(
  [in] PSECURITY_DESCRIPTOR        pSecurityDescriptor,
  [in] SECURITY_DESCRIPTOR_CONTROL ControlBitsOfInterest,
  [in] SECURITY_DESCRIPTOR_CONTROL ControlBitsToSet
);

パラメーター

[in] pSecurityDescriptor

コントロールとリビジョンの情報が設定されている SECURITY_DESCRIPTOR 構造体へのポインター。

[in] ControlBitsOfInterest

設定 する 制御ビットを示すSECURITY_DESCRIPTOR_CONTROL マスク。

[in] ControlBitsToSet

ControlBitsOfInterest マスクで指定されたコントロール ビットの新しい値を示すSECURITY_DESCRIPTOR_CONTROL マスク。

戻り値

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

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

解説

SetSecurityDescriptorControl 関数は、変更するコントロール ビットまたはビット、およびビットがオンかオフかを指定します。

例

次の例では、 セキュリティ記述子 の DACL を保護済みとしてマークします。

    SetSecurityDescriptorControl( &SecDesc,
            SE_DACL_PROTECTED, SE_DACL_PROTECTED );

次の例では、DACL を保護されていないとしてマークします。

    SetSecurityDescriptorControl( &SecDesc,
            SE_DACL_PROTECTED, 0 );

要件

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

関連項目

アクセス制御の概要

基本的なAccess Control関数

GetSecurityDescriptorControl

SECURITY_DESCRIPTOR

SECURITY_DESCRIPTOR_CONTROL

SetSecurityDescriptorDacl