CreateFileShare-Methode der MSFT_FileServer-Klasse
Erstellt eine Dateifreigabe auf dem Dateiserver.
Syntax
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
);
Parameter
Name [in]
Eine teilweise eindeutige (auf den besitzenden Dateiserver beschränkte) und lesbare Zeichenfolge, die zum Identifizieren der Dateifreigabe verwendet wird.
Beschreibung [in]
Eine vom Benutzer festgelegte Beschreibung der Dateifreigabe. Dieses Feld kann verwendet werden, um zusätzliche Freiforminformationen wie Notizen oder Details zur beabsichtigten Verwendung zu speichern.
SourceVolume [in]
Eine Zeichenfolge, die ein eingebettetes MSFT_Volume -Objekt enthält, das das Volume angibt, auf dem die Freigabe erstellt werden soll.
VolumeRelativePath [in]
Der relative Volumepfad eines vorhandenen Verzeichnisses, das freigegeben werden soll. Wenn dieser Parameter nicht angegeben wird, wird eine leere Freigabe erstellt.
ContinuousAvailable [in]
Wenn TRUE, ist die Freigabe kontinuierlich verfügbar.
EncryptData [in]
True gibt an, dass die Freigabedaten während des Transports verschlüsselt werden.
FileSharingProtocol [in]
Das Dateifreigabeprotokoll, das von der Freigabe verwendet werden soll, wenn der Server mehrere Protokolle unterstützt.
NFS (2)
CIFS(SMB) (3)
CreatedFileShare [out]
Dieser Parameter empfängt eine Zeichenfolge, die ein eingebettetes MSFT_FileShare -Objekt enthält, das die neue Dateifreigabe darstellt.
CreatedStorageJob [out]
Gibt einen Verweis auf das Speicherauftragsobjekt zurück, das zum Nachverfolgen des zeitintensiven Vorgangs verwendet wird.
ExtendedStatus [out]
Eine Zeichenfolge, die ein eingebettetes MSFT_StorageExtendedStatus -Objekt enthält.
Dieser Parameter ermöglicht es dem Speicheranbieter, erweiterte (implementierungsspezifische) Fehlerinformationen zurückzugeben.
Rückgabewert
Erfolg (0)
Nicht unterstützt (1)
Nicht angegebener Fehler (2)
Timeout (3)
Fehler (4)
Ungültiger Parameter (5)
Methodenparameter überprüft – Auftrag gestartet (4096)
Größe nicht unterstützt (4097)
Zugriff verweigert (40001)
Es sind nicht genügend Ressourcen vorhanden, um den Vorgang abzuschließen. (40002)
Der angeforderte Zugriffspfad wird bereits verwendet. (42002)
Der Zugriffspfad ist ungültig. (42007)
Sie müssen einen Namen für diese Dateifreigabe angeben. (58000)
Sie müssen ein Freigabeprotokoll für diese Dateifreigabe angeben. (58001)
Sie müssen ein Volume für diese Dateifreigabe angeben. (58002)
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 10 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2016 [nur Desktop-Apps] |
| Namespace | Root\Microsoft\Windows\Storage |
| MOF | Storagewmi.mof |