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
CIMWin32.mof
DLL
CIMWin32.dll

Weitere Informationen

Betriebssystemklassen

_Win32-Verzeichnis