共用方式為

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

指定要為檔案物件設定的共用存取類型。 此值可以是零，或下列旗標的任何組合：

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。

傳回值

無

規格需求

需求 值
最低支援的用戶端 可在 Windows 7 和更新版本的 Windows 中使用。
目標平台 Universal
標頭 wdm.h
程式庫 Ntoskrnl.lib

另請參閱

ACCESS_MASK

IoCreateFile