IoSetShareAccessEx 関数 (wdm.h)

IoSetShareAccessEx ルーチンは、指定されたファイル オブジェクトを共有するためのアクセス権を設定します。

構文

void IoSetShareAccessEx(
  [in]           ACCESS_MASK   DesiredAccess,
  [in]           ULONG         DesiredShareAccess,
  [in, out]      PFILE_OBJECT  FileObject,
  [out]          PSHARE_ACCESS ShareAccess,
  [in, optional] PBOOLEAN      WritePermission
);

パラメーター

[in] DesiredAccess

ファイル オブジェクトに対 して要求されるアクセスの種類を表すACCESS_MASK値を指定します。 システム定義の DesiredAccess フラグの完全な一覧については、「IoCreateFile」を参照してください。

[in] DesiredShareAccess

ファイル オブジェクトに設定する共有アクセスの種類を指定します。 この値には、0 または次のフラグの任意の組み合わせを指定できます。

FILE_SHARE_READ

FILE_SHARE_WRITE

FILE_SHARE_DELETE

[in, out] FileObject

共有アクセスが設定またはリセットされているファイル オブジェクトへのポインター。

[out] ShareAccess

FileObject に関連付けられているSHARE_ACCESS構造体へのポインター。 ドライバーは、この構造体を不透明として扱う必要があります。

[in, optional] WritePermission

ファイル オブジェクトに書き込みアクセス許可があるかどうかを指定する値へのポインター。 共有に書き込みアクセス許可がある場合、この値は TRUE です。それ以外の場合は FALSE です。 値が FALSE で、呼び出し元が排他的読み取りアクセス権を取得しようとすると、書き込みアクセス許可はFILE_SHARE_READにダウングレードされます。

戻り値

なし

必要条件

こちらもご覧ください

ACCESS_MASK

IoCreateFile