IoRemoveShareAccess 関数 (wdm.h)

IoRemoveShareAccess ルーチンは、ファイル オブジェクトの特定の開いているインスタンスのアクセス情報と共有アクセス情報を削除します。

構文

void IoRemoveShareAccess(
  [in]      PFILE_OBJECT  FileObject,
  [in, out] PSHARE_ACCESS ShareAccess
);

パラメーター

[in] FileObject

通常は現在のスレッドによって閉じられているファイル オブジェクトへのポインター。

[in, out] ShareAccess

開いているファイル オブジェクトへの現在のアクセス方法を記述する共有アクセス構造へのポインター。

戻り値

何一つ

備考

このルーチンは、IoUpdateShareAccess をする逆数です。

IoRemoveShareAccess はアトミック操作ではありません。 そのため、このルーチンを呼び出すドライバーは、共有アクセス数の破損を防ぐために、ミューテックスやリソース ロックなどの何らかの種類のロックによって、IoRemoveShareAccess に渡される共有ファイル オブジェクトを保護する必要があります。

IoRemoveShareAccess の呼び出し元は、IRQL = PASSIVE_LEVEL で実行され、FileObject を閉じる 要求したスレッドのコンテキストで実行されている必要があります。

必要条件

要件	価値
サポートされる最小クライアント	Windows 2000 以降で使用できます。
ターゲット プラットフォーム の	万国
ヘッダー	wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む)
ライブラリ	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL (「解説」セクションを参照)
DDI コンプライアンス規則 を する	HwStorPortProhibitedDDDIs(storport), IrqlIoPassive5(wdm), PowerIrpDDis(wdm)

関連項目

IoCheckShareAccess の

IoSetShareAccess の

IoUpdateShareAccess