IStorageProviderCopyHook::CopyCallback-Methode

Bestimmt, ob die Shell einen Ordner im Synchronisierungsstamm eines Cloudanbieters verschieben, kopieren, löschen oder umbenennen darf.

Syntax

HRESULT CopyCallback( 
    HWND hwnd,
    UINT operation,
    UINT flags,
    LPCWSTR srcFile,
    DWORD srcAttribs,
    LPCWSTR destFile,
    DWORD destAttribs,
    UINT* result
);

Parameter

hwnd [ In]

Ein Handle für das Fenster, das der Copy Hook-Handler als übergeordnetes Element für alle Benutzeroberflächenelemente verwenden soll, die der Handler möglicherweise anzeigen muss. Wenn FOF_SILENT im Vorgang angegeben ist, sollte die Methode diesen Parameter ignorieren.

-Vorgang [ In]

Der auszuführende Vorgang. Dieser Parameter kann einer der Werte sein, die unter dem wFunc-Member der SHFILEOPSTRUCT-Struktur aufgeführt sind.

Flags [ In]

Die Flags, die den Vorgang steuern. Dieser Parameter kann mindestens einer der Werte sein, die unter dem fFlags-Member der SHFILEOPSTRUCT-Struktur aufgeführt sind.

Bei Druckerkopierhooks ist dieser Wert einer der folgenden Werte, die in shellapi.h definiert sind.

Wert Beschreibung
PO_DELETE Ein Drucker wird gelöscht. Der srcFile-Parameter zeigt auf den vollständigen Pfad zum angegebenen Drucker.
PO_RENAME Ein Drucker wird umbenannt. Der srcFile-Parameter verweist auf den neuen Namen des Druckers. Der destFile-Parameter verweist auf den alten Namen.
PO_PORTCHANGE Wird nicht unterstützt. Nicht verwenden.
PO_REN_PORT Wird nicht unterstützt. Nicht verwenden.

srcFile [ In]

Ein Zeiger auf eine Zeichenfolge, die den Namen des Quellordners enthält.

srcAttribs [ In]

Die Attribute des Quellordners. Dieser Parameter kann eine Kombination aller Dateiattributflags (FILE_ATTRIBUTE_*) sein, die in den Headerdateien definiert sind. Weitere Informationen finden Sie unter Dateiattributkonstanten.

destFile [ In]

Ein Zeiger auf eine Zeichenfolge, die den Namen des Zielordners enthält.

destAttribs [ In]

Die Attribute des Zielordners. Dieser Parameter kann eine Kombination aller Dateiattributflags (FILE_ATTRIBUTE_*) sein, die in den Headerdateien definiert sind. Weitere Informationen finden Sie unter Dateiattributkonstanten.

Ergebnis [ out]

Der ganzzahlige Wert, der angibt, ob die Shell den Vorgang ausführen soll. Einer der folgenden:

Wert Beschreibung
IDYES Lässt den Vorgang zu.
IDNO Verhindert den Vorgang für diesen Ordner, wird aber mit allen anderen genehmigten Vorgängen (z. B. einem Batchkopiervorgang) fortgesetzt.
IDCANCEL Verhindert den aktuellen Vorgang und bricht alle ausstehenden Vorgänge ab.

Rückgabewert

Gibt S_OK zurück, wenn erfolgreich, oder andernfalls einen Fehlercode.

Hinweise

Die Shell ruft den Copy Hook-Handler des Cloudanbieters für jeden Ordner unter dem registrierten Synchronisierungsstamm auf. Legen Sie zum Registrieren eines Copy Hook-Handlers für Cloudordner den CopyHook-Wert unter dem Schlüssel HKEY_LOCAL_MACHINE/Software/Microsoft/Windows/CurrentVersion/Explorer/SyncRootManager/{SyncRootId} auf die CLSID des Copy Hook-Objekts fest.

Wenn die CopyCallback-Methode aufgerufen wird, initialisiert die Shell die IStorageProviderCopyHook-Schnittstelle direkt, ohne zuerst eine IShellExtInit-Schnittstelle zu verwenden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10 Insider Preview Build 19624
Header shobjidl.h

Siehe auch

Erstellen eines Cloudsynchronisierungsmoduls, das Platzhalterdateien unterstützt