次の方法で共有

GetInheritanceSourceA 関数 (aclapi.h)

  • [アーティクル]

この関数のこのバージョンはサポートされていません。 この関数のワイド文字バージョン (GetInheritanceSourceW) がサポートされています。

構文

DWORD GetInheritanceSourceA(
  [in]           LPSTR                 pObjectName,
  [in]           SE_OBJECT_TYPE        ObjectType,
  [in]           SECURITY_INFORMATION  SecurityInfo,
  [in]           BOOL                  Container,
  [in, optional] GUID                  **pObjectClassGuids,
  [in]           DWORD                 GuidCount,
  [in]           PACL                  pAcl,
  [in, optional] PFN_OBJECT_MGR_FUNCTS pfnArray,
  [in]           PGENERIC_MAPPING      pGenericMapping,
  [out]          PINHERITED_FROMA      pInheritArray
);

パラメーター

[in] pObjectName

チェックする ACL を使用するオブジェクトの名前へのポインター。

[in] ObjectType

pObjectNameで示されるオブジェクトの型。 使用可能な値は、SE_FILE_OBJECT、SE_REGISTRY_KEY、SE_DS_OBJECT、およびSE_DS_OBJECT_ALLです。

[in] SecurityInfo

オブジェクトで使用される ACL の種類。 指定できる値は、DACL_SECURITY_INFORMATIONまたはSACL_SECURITY_INFORMATIONです。

[in] Container

オブジェクトがコンテナー オブジェクトの場合は TRUE 、オブジェクトがリーフ オブジェクトの場合は FALSE を します。 リーフ オブジェクトはSE_FILE_OBJECTのみであることに注意してください。

[in, optional] pObjectClassGuids

pObjectNameに関連付けられているオブジェクトの種類または名前 識別する GUID の省略可能なリスト。 これは、オブジェクト マネージャーが 1 つのオブジェクト クラスのみをサポートしている場合、またはオブジェクト クラスに関連付けられている GUID がない場合は、null 可能性があります。

[in] GuidCount

pObjectClassGuids指す GUID の数。

[in] pAcl

オブジェクトの ACL。

[in, optional] pfnArray

引っ込み思案。 このパラメーターを NULL設定します。

[in] pGenericMapping

オブジェクトの特定の権限への汎用権限のマッピング。

[out] pInheritArray

GetInheritanceSource 関数が継承情報を入力する INHERITED_FROM 構造体の配列へのポインター。 呼び出し元は、ACL 内の各 ACE のエントリに十分なメモリを割り当てる必要があります。

戻り値

関数が成功した場合、関数はERROR_SUCCESSを返します。

関数が失敗した場合、WinError.h で定義された 0 以外のエラー コードが返されます。

備考

GetInheritanceSource 関数は、INHERITED_FROM 構造体で返される名前にメモリを割り当てます。 関数がこのメモリの使用を終了したら、呼び出し元のプログラムは FreeInheritedFromArray呼び出して解放する必要があります。 呼び出し元は配列自体のメモリを提供する必要があることに注意してください。 呼び出し元がメモリを割り当てた場合、呼び出し元は FreeInheritedFromArray呼び出した後、そのメモリを解放する必要があります。

この関数は競合状態を処理しません。 別のスレッドがオブジェクトの セキュリティ記述子を変更したおおよその時点でこの関数を呼び出すと、この関数は失敗する可能性があります。

手記

aclapi.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして GetInheritanceSource を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows XP [デスクトップ アプリのみ]
サポートされる最小サーバー Windows Server 2003 [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー aclapi.h
ライブラリ Advapi32.lib
DLL Advapi32.dll

関連項目

FreeInheritedFromArray を する