ISharingConfigurationManager::CreateShare メソッド (shobjidl_core.h)

  • [アーティクル]

[ユーザー] フォルダーまたは [パブリック] フォルダーを共有します。 フォルダーが既に共有されている場合、このメソッドは共有状態を更新します。

構文

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

パラメーター

[in] dsid

種類: DEF_SHARE_ID

共有または更新するフォルダーを示す DEF_SHARE_ID 値の 1 つ。

[in] role

種類: SHARE_ROLE

Everyone ACE の共有のアクセス許可を設定する次のSHARE_ROLE値のいずれか。 CreateShare は 、これらの値のみを受け入れます。

SHARE_ROLE_READER (0)

読み取り専用です。 フォルダーの内容は読み取ることができますが、変更または追加することはできません。

SHARE_ROLE_CO_OWNER (2)

読み取り/書き込み。 フォルダーの内容は、読み取り、変更、または追加できます。

戻り値

種類: HRESULT

成功した場合はS_OKを返し、それ以外の場合は次のようなエラー値を返します。

リターン コード 説明
E_INVALIDARG
 role パラメーターは、SHARE_ROLE_READERまたはSHARE_ROLE_CO_OWNER以外の値を指定します。

注釈

このメソッドを実行するには、管理者特権レベルが必要です。

dsid でという名前のフォルダーが共有されていない場合、このメソッドは role パラメーターで指定されたアクセス許可レベルを使用してフォルダーを共有します。

dsid でという名前のフォルダーが既に共有されている場合、このメソッドは、ロール パラメーターで指定された値を使用して共有に対するアクセス許可を更新します。

Windows 7 の時点では 、パブリック フォルダーは直接ではなく ユーザー を介して共有されるため、 パブリック に共有を作成すると、サーバー メッセージ ブロック (SMB) 共有が ユーザーに作成されます。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー shobjidl_core.h (Shobjidl.h を含む)