ISharingConfigurationManager：：CreateShare 方法 (shobjidl_core.h)

共用 [使用者 ] 或 [ 公用資料夾 ]。如果資料夾已經共享，這個方法會更新其共享狀態。

語法

HRESULT CreateShare(
  [in] DEF_SHARE_ID dsid,
  [in] SHARE_ROLE   role
);

[in] dsid

類型： DEF_SHARE_ID

其中一個 DEF_SHARE_ID 值，指出要共用或更新的資料夾。

[in] role

類型： SHARE_ROLE

下列其中一個 SHARE_ROLE 值，可設定 所有人 ACE 共用的訪問許可權。 CreateShare 只接受這些值。

唯讀。可以讀取資料夾的內容，但無法變更或新增至。

讀取/寫入。您可以讀取、變更或新增資料夾的內容。

類型： HRESULT

如果成功，則傳回S_OK，否則傳回錯誤值，包括下列專案：

傳回碼	Description
E_INVALIDARG	角色參數會指定SHARE_ROLE_READER或SHARE_ROLE_CO_OWNER以外的值。

執行此方法需要系統管理員許可權等級。

如果未共用 dsid 中名為的資料夾，這個方法會使用角色參數中提供的許可權等級來共享資料夾。

如果 dsid 中名為的資料夾已經共享，這個方法會以角色參數中提供的值來更新共享的許可權。

因為從 Windows 7 開始，公用資料夾是透過用戶共用，而不是直接在公用上建立共用，所以在 [使用者] 上建立伺服器消息塊 (SMB) 共用。