MSFT_FileServer クラスの CreateFileShare メソッド
ファイル サーバーにファイル共有を作成します。
構文
UInt32 CreateFileShare(
[in] String Name,
[in] String Description,
[in] String SourceVolume,
[in] String VolumeRelativePath,
[in] Boolean ContinuouslyAvailable,
[in] Boolean EncryptData,
[in] UInt16 FileSharingProtocol,
[out] String CreatedFileShare,
[out] MSFT_StorageJob REF CreatedStorageJob,
[out] String ExtendedStatus
);
パラメーター
Name [in]
ファイル共有の識別に使用される、部分的に一意 (所有するファイル サーバーをスコープとする) の、人間が判読できる文字列。
Description [in]
ユーザーが設定可能なファイル共有の説明。 このフィールドを使用すると、メモや用途に関する詳細など、自由形式の情報を追加して格納できます。
SourceVolume [in]
共有を作成するボリュームを指定する、埋め込み MSFT_Volume オブジェクトを含む文字列。
VolumeRelativePath [in]
共有する既存のディレクトリのボリューム相対パス。 このパラメーターを指定しない場合は、空の共有が作成されます。
ContinuouslyAvailable [in]
TRUE の場合、共有は継続的に使用できます。
EncryptData [in]
TRUE の場合、共有データは転送中に暗号化されます。
FileSharingProtocol [in]
サーバーが複数のプロトコルをサポートしている場合に、共有で使用されるファイル共有プロトコル。
NFS (2)
CIFS(SMB) (3)
CreatedFileShare [out]
このパラメーターは、新しいファイル共有を表す埋め込み MSFT_FileShare オブジェクトを含む文字列を受け取ります。
CreatedStorageJob [out]
実行時間の長い操作を追跡するために使用されるストレージ ジョブ オブジェクトへの参照を返します。
ExtendedStatus [out]
埋め込み MSFT_StorageExtendedStatus オブジェクトを含む文字列。
このパラメーターを使用すると、ストレージ プロバイダーは拡張 (実装固有の) エラー情報を返せます。
戻り値
成功 (0)
サポート非対称 (1)
不明なエラー (2)
タイムアウト (3)
失敗 (4)
無効なパラメーター (5)
メソッド パラメーター チェック済み - ジョブが開始されました (4096)
サイズがサポートされていません (4097)
アクセスが拒否されました (40001)
リソース不足のため、操作を完了できません。 (40002)
要求されたアクセス パスは既に使用されています。 (42002)
アクセス パスが有効ではありません。 (42007)
このファイル共有名を指定する必要があります。 (58000)
このファイル共有の共有プロトコルを指定する必要があります。 (58001)
このファイル共有のボリュームを指定する必要があります。 (58002)
要件
| 要件 | Value |
|---|---|
| サポートされている最小のクライアント | Windows 10 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2016 [デスクトップ アプリのみ] |
| 名前空間 | Root\Microsoft\Windows\Storage |
| MOF | Storagewmi.mof |