Folder.CopyHere-Methode

Kopiert ein Element oder Elemente in einen Ordner.

Syntax

Folder.CopyHere(
  vItem,
  [ vOptions ]
)

Parameter

vItem

Typ: Variant

Das oder die zu kopierenden Elemente. Dies kann eine Zeichenfolge sein, die einen Dateinamen, ein FolderItem-Objekt oder ein FolderItems-Objekt darstellt.

vOptions [optional]

Typ: Variant

Optionen für den Kopiervorgang. Dieser Wert kann null oder eine Kombination der folgenden Werte sein. Diese Werte basieren auf Flags, die für die Verwendung mit dem fFlags-Member der C++- SHFILEOPSTRUCT-Struktur definiert sind. Jeder Shell-Namespace muss eine eigene Implementierung dieser Flags bereitstellen, und jeder Namespace kann einige oder sogar alle diese Flags ignorieren. Diese Flags sind nicht durch den Namen für Visual Basic, VBScript oder JScript definiert, daher müssen Sie sie selbst definieren oder ihre numerischen Entsprechungen verwenden.

Hinweis

In einigen Fällen, z. B. komprimierte Dateien (.zip), können einige Optionsflags designbedingt ignoriert werden.

 

(4)

Zeigt kein Statusdialogfeld an.

(8)

Geben Sie der Datei, die mit einem neuen Namen in einem Vorgang zum Verschieben, Kopieren oder Umbenennen ausgeführt wird, wenn bereits eine Datei mit dem Zielnamen vorhanden ist.

(16)

Antworten Sie mit "Ja zu allen" für jedes angezeigte Dialogfeld.

(64)

Behalten Sie nach Möglichkeit Informationen zum Rückgängigmachen bei.

(128)

Führen Sie den Vorgang nur für Dateien aus, wenn ein Platzhalterdateiname (*.*) angegeben ist.

(256)

Zeigen Sie ein Statusdialogfeld an, aber nicht die Dateinamen.

(512)

Bestätigen Sie die Erstellung eines neuen Verzeichnisses nicht, wenn für den Vorgang ein Verzeichnis erstellt werden muss.

(1024)

Zeigen Sie keine Benutzeroberfläche an, wenn ein Fehler auftritt.

(2048)

Version 4.71. Kopieren Sie die Sicherheitsattribute der Datei nicht.

(4096)

Nur im lokalen Verzeichnis ausgeführt werden. Arbeiten Sie nicht rekursiv in Unterverzeichnissen.

(8192)

Version 5.0. Kopieren Sie verbundene Dateien nicht als Gruppe. Kopieren Sie nur die angegebenen Dateien.

Rückgabewert

Diese Methode gibt keinen Wert zurück.

Bemerkungen

Das aufrufende Programm wird nicht benachrichtigt, um anzugeben, dass die Kopie abgeschlossen ist.

Hinweis

Nicht alle Methoden werden für alle Ordner implementiert. Beispielsweise wird die ParseName-Methode nicht für den ordner Systemsteuerung (CSIDL_CONTROLS) implementiert. Wenn Sie versuchen, eine nicht implementierte Methode aufzurufen, wird ein 0x800A01BD -Fehler (dezimal 445) ausgelöst.

 

Beispiele

Im folgenden Beispiel wird CopyHere verwendet, um die Autoexec.bat-Datei aus dem Stammverzeichnis in das Verzeichnis C:\Windows zu kopieren. Die ordnungsgemäße Verwendung wird für JScript, VBScript und Visual Basic angezeigt.

Jscript:

<script language="JScript">
    function fnCopyHereJ()
    {
        var objShell = new ActiveXObject("shell.application");
        var objFolder = new Object;
        
        objFolder = objShell.NameSpace("C:\\WINDOWS");
        if (objFolder != null)
        {
            objFolder.CopyHere("C:\\AUTOEXEC.BAT");
        }
    }
 </script>

Vbscript:

<script language="VBScript">
    function fnCopyHereVB()
        dim objShell
        dim objFolder
        
        set objShell = CreateObject("shell.application")
        set objFolder = objShell.NameSpace("C:\WINDOWS")
 
        if not objFolder is nothing then
            objFolder.CopyHere("C:\AUTOEXEC.BAT")
        end if
 
        set objShell = nothing
        set objFolder = nothing
    end function
</script>

Visual Basic:

Private Sub btnCopyHere_Click()
    Dim objShell  As Shell
    Dim objFolder As Folder
    
    Set objShell = New Shell
    Set objFolder = objShell.NameSpace("C:\WINDOWS")
 
    If (Not objFolder Is Nothing) Then
        objFolder.CopyHere ("C:\AUTOEXEC.BAT")
    End If
 
    Set objFolder = Nothing
    Set objShell = Nothing
End Sub

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Header	Shldisp.h
IDL	Shldisp.idl
DLL	Shell32.dll (Version 4.71 oder höher)

Siehe auch

Ordner