共用方式為

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。
目標平臺 普遍
標頭 wdm.h
連結庫 Ntoskrnl.lib

另請參閱

ACCESS_MASK

IoCreateFile