IoSetLinkShareAccess 関数 (wdm.h)

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

構文

void IoSetLinkShareAccess(
  [in]                ACCESS_MASK        DesiredAccess,
  [in]                ULONG              DesiredShareAccess,
  [in, out]           PFILE_OBJECT       FileObject,
  [in, out]           PSHARE_ACCESS      ShareAccess,
  [in, out, optional] PLINK_SHARE_ACCESS LinkShareAccess,
  [in]                ULONG              IoShareAccessFlags
);

パラメーター

[in] DesiredAccess

指定 したファイル オブジェクトへのアクセスの目的の種類を示すACCESS_MASK値を指定します。

[in] DesiredShareAccess

現在開いている要求のファイル オブジェクトへの共有アクセスの目的の種類を指定します。 通常、このパラメーターの値は、開いている要求が行われたときに I/O マネージャーによってファイル システムまたは最上位ドライバーに渡される ShareAccess パラメーターと同じです。 この値には、0 または次の任意の組み合わせを指定できます。

FILE_SHARE_READ

FILE_SHARE_WRITE

FILE_SHARE_DELETE

[in, out] FileObject

現在開いている要求のアクセスをチェックするファイル オブジェクトへのポインター。

[in, out] ShareAccess

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

[in, out, optional] LinkShareAccess

FileObject に関連付けられている共通リンク共有アクセス データ構造 (LINK_SHARE_ACCESS) へのポインター。 ドライバーは、この構造体を不透明として扱う必要があります。

[in] IoShareAccessFlags

これらのフラグのビットマスク:

IO_SHARE_ACCESS_NO_WRITE_PERMISSION (0x80000000) は、ユーザーにファイルの書き込みアクセス許可がないことを指定します。 このフラグは、ユーザーが適切なアクセス許可を持っていない場合に、排他読み取りアクセス用にファイルを開かないようにするために使用されます。

IO_CHECK_SHARE_ACCESS_UPDATE_SHARE_ACCESS (0x00000001) は、SHARE_ACCESS構造体が更新されるかどうかを示します。

戻り値

なし

必要条件

こちらもご覧ください

IoCheckLinkShareAccess

IoRemoveLinkShareAccess

IoUpdateLinkShareAccess