Copy-Methode der Win32_Directory-Klasse

Die CopyWMI-Klassenmethode kopiert die im Objektpfad angegebene Eintragsdatei oder das Verzeichnis des logischen Verzeichnisses an den durch den Eingabeparameter angegebenen Speicherort. Eine Kopie wird nicht unterstützt, wenn das Überschreiben einer vorhandenen logischen Datei erforderlich ist.

In diesem Thema wird 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

Vollqualifizierter 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, die auf einen Fehler hinweist.

0

Die Anforderung wurde erfolgreich gesendet.

2

Der Zugriff wurde verweigert.

8

Ein nicht angegebener Fehler ist 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 Verstoß gegen die Freigabe aufgetreten.

16

Die angegebene Startdatei war ungültig.

17

Eine für den Vorgang erforderliche Berechtigung wird nicht gehalten.

21

Ein angegebener Parameter ist ungültig.

Bemerkungen

Ordner müssen häufig von einem Speicherort an einen anderen kopiert werden. Sie können beispielsweise 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 instance des zu kopierenden Ordners zurück und rufen dann die Copy-Methode auf, wobei sie den Zielspeicherort für die neue Kopie des Ordners als Parameter übergeben. Mit dieser Codezeile wird beispielsweise ein Ordner in den Ordner Skripts 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 namens Scripts und versuchen, diesen Ordner in eine Remotefreigabe namens \\atl-fs-01\archive zu kopieren. Wenn auf dieser Freigabe bereits ein Ordner namens Scripts vorhanden ist, schlägt der Kopiervorgang fehl.

Beispiele

Im folgenden Codebeispiel, das aus dem Kopieren eines Ordners mithilfe von WMI stammt, wird die Copy-Methode verwendet, um den Ordner C:\Scripts nach D:\Archive 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)	WindowsServer 2008
Namespace	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

Siehe auch

Betriebssystemklassen

Win32_Directory