Copy-Methode der Win32 _ Directory-Klasse
Die Methode WMI-Klasse kopieren kopiert die im Objektpfad angegebene logische Verzeichniseintragsdatei oder das verzeichnis an den speicherort, der durch den Eingabeparameter angegeben wird. Eine Kopie wird nicht unterstützt, wenn das Überschreiben einer vorhandenen logischen Datei erforderlich ist.
In diesem Thema wird die MOF-Syntax (Managed Object Format) verwendet. Weitere Informationen zur Verwendung dieser Methode finden Sie unter Aufrufen einer Methode.
Syntax
uint32 Copy(
string FileName
);
Parameter
-
FileName
-
Vollqualifizierte Name der Kopie der Datei (oder des Verzeichnisses). Beispiel: c: \ temp \ newdirectory
Rückgabewert
Gibt den Wert 0 (null) zurück, wenn die Datei erfolgreich kopiert wurde, und eine beliebige andere Zahl, um einen Fehler anzugeben.
-
0
-
Die Anforderung wurde erfolgreich gesendet.
-
2
-
Der Zugriff wurde verweigert.
-
8
-
Es ist ein nicht angegebener Fehler aufgetreten.
-
9
-
Der angegebene Name war ungültig.
-
10
-
Das angegebene Objekt ist bereits vorhanden.
-
11
-
Das Dateisystem ist nicht NTFS.
-
12
-
Die Plattform ist nicht Windows.
-
13
-
Das Laufwerk ist nicht identisch.
-
14
-
Das Verzeichnis ist nicht leer.
-
15
-
Es ist ein Freigabeverstoß aufgetreten.
-
16
-
Die angegebene Startdatei war ungültig.
-
17
-
Für den Vorgang ist keine Berechtigung erforderlich.
-
21
-
Ein angegebener Parameter ist ungültig.
Hinweise
Ordner müssen häufig von einem Speicherort an einen anderen kopiert werden. Beispielsweise können Sie einen Ordner von einem Server auf einen anderen kopieren, um eine Sicherungskopie dieses Ordners zu erstellen. Oder Sie verfügen über einen Vorlagenordner, der auf Benutzerarbeitsstationen kopiert werden muss, oder einen Skriptordner, der auf alle DNS-Server kopiert werden soll.
Mit der Win32 _ Directory Copy-Methode können Sie einen Ordner von einem Speicherort an einen anderen kopieren, entweder auf demselben Computer (z. B. beim Kopieren eines Ordners von Laufwerk C auf Laufwerk D) oder auf einem Remotecomputer. Um einen Ordner zu kopieren, geben Sie eine Instanz des zu kopierenden Ordners zurück und rufen dann die Copy-Methode auf, wobei Sie als Parameter den Zielspeicherort für die neue Kopie des Ordners übergeben. Mit dieser Codezeile wird beispielsweise ein Ordner in den Ordner Scripts auf Laufwerk F kopiert:
objFolder.Copy("F:\Scripts")
WMI überschreibt beim Ausführen der Copy-Methode keinen vorhandenen Ordner. Dies bedeutet, dass der Kopiervorgang fehlschlägt, wenn der Zielordner vorhanden ist. Angenommen, Sie verfügen über einen Ordner mit dem Namen Scripts und versuchen, diesen Ordner in eine Remotefreigabe mit dem Namen \ \ atl-fs-01 archive zu \ kopieren. Wenn auf dieser Freigabe bereits ein Ordner mit dem Namen Scripts vorhanden ist, schlägt der Kopiervorgang fehl.
Beispiele
Im folgenden Codebeispiel aus dem Copy a Folder Using WMI (Kopieren eines Ordners mithilfe von WMI)wird die Copy-Methode verwendet, um den Ordner C: \ Scripts to D: Archive (C: Skripts in D: Archiv) zu \ kopieren.
strComputer = "."
Set objWMIService = GetObject("winmgmts:" _
& "{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2")
Set colFolders = objWMIService.ExecQuery( _
"Select * from Win32_Directory where Name = 'c:\\Scripts'")
For Each objFolder in colFolders
errResults = objFolder.Copy("D:\Archive")
Next
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista |
| Unterstützte Mindestversion (Server) |
Windows Server 2008 |
| Namespace |
\Stamm-CIMV2 |
| MOF |
|
| DLL |
|