CopyEx-Methode der CIM_DataFile-Klasse
Die CopyEx-Methode kopiert die logische Datei (oder das Verzeichnis), die im Objektpfad angegeben ist, an den durch den FileName-Parameter angegebenen Speicherort. Eine Kopie wird nicht unterstützt, wenn eine vorhandene logische Datei überschrieben werden muss. Diese Methode ist eine erweiterte Version der Copy-Methode und wird von CIM_LogicalFile geerbt.
Wichtig
Die CIM-Klassen (Common Information Model) von DMTF (Distributed Management Task Force) sind die übergeordneten Klassen, auf denen WMI-Klassen erstellt werden. WMI unterstützt derzeit nur die CIM 2.x-Versionsschemas.
In diesem Thema wird MOF-Syntax (Managed Object Format) verwendet. Weitere Informationen zur Verwendung dieser Methode finden Sie unter Aufrufen einer Methode.
Syntax
uint32 CopyEx(
[in] string FileName,
[out] string REF StopFileName,
[in] string StartFileName,
[in] boolean Recursive
);
Parameter
-
FileName [in]
-
Vollqualifizierter Name der Zieldatei (oder des Verzeichnisses).
Beispiel: "c:\temp\newdirectory"
-
StopFileName [out]
-
Zeichenfolge, die den Namen der Datei (oder des Verzeichnisses) darstellt, in der die Methode fehlgeschlagen ist. Dieser Parameter ist NULL , wenn die Methode erfolgreich ist.
-
StartFileName [in]
-
Zeichenfolge, die die untergeordnete Datei (oder das untergeordnete Verzeichnis) darstellt, die als Ausgangspunkt für diese Methode verwendet werden soll. In der Regel ist der StartFileName-Parameter der StopFileName-Parameter , der die Datei (oder das Verzeichnis) angibt, an der beim vorherigen Methodenaufruf ein Fehler aufgetreten ist. Wenn dieser Parameter NULL ist, wird der Vorgang für die im ExecMethod-Aufruf angegebene Datei (oder das Verzeichnis) ausgeführt.
Wenn StartFileName verwendet wird, muss Recursive ebenfalls auf true festgelegt werden.
-
Rekursiv [in]
-
Wenn TRUE, wird die -Methode auch rekursiv auf Dateien und Verzeichnisse in dem Verzeichnis angewendet, das vom CIM_DataFile instance angegeben wird. Bei Dateiinstanzen wird dieser Parameter ignoriert.
Rückgabewert
Gibt bei Erfolg den Wert 0 (Null) und eine beliebige andere Zahl zurück, um einen Fehler anzuzeigen. Weitere Fehlercodes finden Sie unter WMI-Fehlerkonstanten oder WbemErrorEnum. Allgemeine HRESULT-Werte finden Sie unter Systemfehlercodes.
-
0
Erfolg.
-
2
Zugriff verweigert.
-
8
Nicht angegebener Fehler.
-
9
Ungültiges Objekt.
-
10
Das Objekt ist bereits vorhanden.
-
11
Dateisystem nicht NTFS.
-
12
Plattform nicht Windows.
-
13
Laufwerk nicht gleich.
-
14
„Verzeichnis ist nicht leer.“
-
15
Freigabeverletzung.
-
16
Ungültige Startdatei.
-
17
Berechtigung nicht gehalten.
-
21
Ungültiger Parameter.
Bemerkungen
Die CopyEx-Methode in CIM_DataFile wird von WMI implementiert.
Diese Dokumentation wird von den CIM-Klassenbeschreibungen abgeleitet, die von der DMTF veröffentlicht werden. Microsoft hat möglicherweise Änderungen vorgenommen, um kleinere Fehler zu korrigieren, den Microsoft SDK-Dokumentationsstandards zu entsprechen oder weitere Informationen bereitzustellen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista |
| Unterstützte Mindestversion (Server) |
WindowsServer 2008 |
| Namespace |
Root\CIMV2 |
| MOF |
|
| DLL |
|