ioRemoveShareAccess 函式 (wdm.h)

IoRemoveShareAccess 例程會移除檔案物件指定開啟實例的存取和共用存取資訊。

語法

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

參數

[in] FileObject

檔案物件的指標，通常是由目前線程所關閉。

[in, out] ShareAccess

共用存取結構的指標，描述目前如何存取開啟的檔案物件。

傳回值

無

備註

此例程是 IoUpdateShareAccess的倒數。

IoRemoveShareAccess 不是不可部分完成的作業。 因此，呼叫此例程的驅動程式必須透過某種類型的鎖定來保護傳遞至 IoRemoveShareAccess 的共用檔案物件，例如 mutex 或資源鎖定，以避免共用存取計數損毀。

IoRemoveShareAccess 的呼叫端必須在 IRQL = PASSIVE_LEVEL 執行，並在要求關閉 FileObject 的線程內容中執行。

規格需求

另請參閱

IoCheckShareAccess

IoSetShareAccess

IoUpdateShareAccess