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 |
|
| Idl |
|
| DLL |
|