AuthzInitializeResourceManager 関数 (authz.h)

AuthzInitializeResourceManager 関数は、Authz を使用して、クライアントがさまざまなリソースにアクセスできるかどうかを確認します。

構文

AUTHZAPI BOOL AuthzInitializeResourceManager(
  [in]           DWORD                            Flags,
  [in, optional] PFN_AUTHZ_DYNAMIC_ACCESS_CHECK   pfnDynamicAccessCheck,
  [in, optional] PFN_AUTHZ_COMPUTE_DYNAMIC_GROUPS pfnComputeDynamicGroups,
  [in, optional] PFN_AUTHZ_FREE_DYNAMIC_GROUPS    pfnFreeDynamicGroups,
  [in]           PCWSTR                           szResourceManagerName,
  [out]          PAUTHZ_RESOURCE_MANAGER_HANDLE   phAuthzResourceManager
);

パラメーター

[in] Flags

リソース マネージャーの初期化方法を定義する DWORD 値。 このパラメーターには、次の値を含めることができます。

AUTHZ_RM_FLAG_NO_AUDITとAUTHZ_RM_FLAG_INITIALIZE_UNDER_IMPERSONATIONはビット単位で組み合わせることができます。

[in, optional] pfnDynamicAccessCheck

AuthzAccessCheck または AuthzCachedAccessCheck のアクセス制御リスト (ACL) の評価中に、リソース マネージャーがコールバック アクセス制御エントリ (ACE) を検出するたびに呼び出す AuthzAccessCheckCallback コールバック関数へのポインター。 コールバック関数チェックアクセスが使用されていない場合、このパラメーターは NULL にすることができます。

[in, optional] pfnComputeDynamicGroups

AuthzClientContext ハンドルの初期化中にリソース マネージャーによって呼び出される AuthzComputeGroupsCallback コールバック関数へのポインター。 動的グループの計算にコールバック関数を使用しない場合、このパラメーターは NULL にすることができます 。

[in, optional] pfnFreeDynamicGroups

コンピューティング動的グループ コールバックによって割り当てられたセキュリティ識別子 (SID) 属性配列を解放するためにリソース マネージャーによって呼び出される AuthzFreeGroupsCallback コールバック関数へのポインター。 動的グループの計算にコールバック関数を使用しない場合、このパラメーターは NULL にすることができます 。

[in] szResourceManagerName

リソース マネージャーを識別する文字列。 リソース マネージャーに名前が必要ない場合は、このパラメーターを NULL にすることができます 。

[out] phAuthzResourceManager

返されたリソース マネージャー ハンドルへのポインター。 ハンドルの使用が完了したら、 AuthzFreeResourceManager 関数を呼び出してハンドルを解放します。

戻り値

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

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

要件

関連項目

AuthzAccessCheck

AuthzCachedAccessCheck

AuthzFreeResourceManager

基本的なAccess Control関数