IAccessControl::GetAllAccessRights メソッド (iaccess.h)

指定したオブジェクトのアクセス権または所有者とグループの一覧全体を取得します。

構文

HRESULT GetAllAccessRights(
  [in]  LPWSTR                            lpProperty,
  [out] PACTRL_ACCESSW_ALLOCATE_ALL_NODES *ppAccessList,
  [out] PTRUSTEEW                         *ppOwner,
  [out] PTRUSTEEW                         *ppGroup
);

パラメーター

[in] lpProperty

プロパティの名前。 IAccessControl の COM 実装を使用している場合、このパラメーターは NULL である必要があります。

[out] ppAccessList

アクセス リスト構造体へのポインターを受け取るポインター変数のアドレス。 このパラメーターを ACTRL_ACCESSすることはできません。

呼び出しが成功した場合、呼び出し元は CoTaskMemFree 関数を使用して割り当てられたメモリを解放する必要があります。 メモリは allocate(all_nodes) です。つまり、すべてのサブ構造体が 1 つのブロックに割り当てられます。 したがって、 CoTaskMemFree を 1 回呼び出すことで、データ構造全体を解放する必要があります。

[out] ppOwner

所有者情報を受け取る トラスティ 構造体へのポインター。 このパラメーターが NULL ではなく、関数が成功した場合、呼び出し元は CoTaskMemFree を使用してメモリを解放する必要があります。

[out] ppGroup

グループ情報を受け取る トラスティ 構造体へのポインター。 このパラメーターが NULL ではなく、関数が成功した場合、呼び出し元は CoTaskMemFree を使用してメモリを解放する必要があります。

戻り値

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

要件

こちらもご覧ください

ACTRL_ACCESS

IAccessControl