RsopFileAccessCheck 関数 (userenv.h)

RSoPFileAccessCheck 関数は、ファイルのセキュリティ記述子が、RSOPTOKEN によって識別されるクライアントに対して指定されたファイル アクセス権のセットを付与するかどうかを決定します。

構文

USERENVAPI HRESULT RsopFileAccessCheck(
  [in]  LPWSTR     pszFileName,
  [in]  PRSOPTOKEN pRsopToken,
  [in]  DWORD      dwDesiredAccessMask,
  [out] LPDWORD    pdwGrantedAccessMask,
  [out] LPBOOL     pbAccessStatus
);

パラメーター

[in] pszFileName

関連するファイルの名前へのポインター。 ファイルは既に存在している必要があります。

[in] pRsopToken

ファイルへのアクセスを試みるクライアントを表す有効な RSOPTOKEN へのポインター。

[in] dwDesiredAccessMask

チェックへのアクセス権を示すアクセス マスクを指定します。 このマスクには、 ジェネリック、 標準、および特定のアクセス権の組み合わせを含めることができます。 詳細については、「 Access Rights and Access Masks」を参照してください。

[out] pdwGrantedAccessMask

付与されたアクセス権を受け取るアクセス マスクへのポインター。

関数が成功すると、 pbAccessStatus パラメーターが TRUE に設定され、マスクが更新され、付与された標準権限と特定の権限が含まれます。 pbAccessStatus が FALSE に設定されている場合、このパラメーターは 0 に設定されます。 関数が失敗した場合、マスクは変更されません。

[out] pbAccessStatus

アクセス チェックの結果を受け取る変数へのポインター。

関数が成功し、要求されたアクセス権のセットが付与された場合、このパラメーターは TRUE に設定されます。 それ以外の場合、このパラメーターは FALSE に設定されます。 関数が失敗した場合、状態は変更されません。

戻り値

関数が成功した場合、戻り値は S_OK。 それ以外の場合、この関数は Platform SDK ヘッダー ファイル WinError.h で定義されている COM エラー コードのいずれかを返します。

注釈

RSoPFileAccessCheck 関数は、pbAccessStatus パラメーターで、RSOPTOKEN によって識別されるクライアントへのアクセスが許可または拒否されるかどうかを示します。 アクセスが許可されている場合、要求されたアクセス マスクは、オブジェクトに付与されたアクセス マスクになります。

要件

こちらもご覧ください

グループ ポリシー関数

グループ ポリシーの概要

RSoPAccessCheckByType