Folder.CopyHere-Methode

Kopiert ein Element oder Elemente in einen Ordner.

Syntax

Folder.CopyHere(
  vItem,
  [ vOptions ]
)

Parameter

vItem

Typ: Variant

Das zu kopierende Element oder die zu kopierende 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 0 (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 Shellnamespace muss eine eigene Implementierung dieser Flags bereitstellen, und jeder Namespace kann einige oder sogar alle dieser Flags ignorieren. Diese Flags werden nicht anhand des Namens 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. komprimierten Dateien (ZIP-Dateien), werden einige Optionsflags möglicherweise entwurfsweise ignoriert.

(4)

Zeigen Sie kein Statusdialogfeld an.

(8)

Geben Sie der Datei, die mit einem neuen Namen betrieben wird, einen Verschiebungs-, Kopier- oder Umbenennungsvorgang, wenn bereits eine Datei mit dem Zielnamen vorhanden ist.

(16)

Antworten Sie für alle angezeigten Dialogfelder mit "Ja zu allen".

(64)

Behalten Sie nach Möglichkeit rückgängige Informationen bei.

(128)

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

(256)

Zeigt ein Statusdialogfeld an, zeigt jedoch nicht die Dateinamen an.

(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 nicht die Sicherheitsattribute der Datei.

(4096)

Wird nur im lokalen Verzeichnis verwendet. Arbeiten Sie nicht rekursiv in Unterverzeichnisse.

(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.

Hinweise

Das aufrufende Programm erhält keine Benachrichtigung, um anzugeben, dass die Kopie abgeschlossen wurde.

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 (Dezimalzahl 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 richtige 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, nur Windows [ XP-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