IStorageProviderCopyHook::CopyCallback-Methode

Artikel
06/13/2023

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 Kopierhakenhandler als übergeordnetes Element für alle Benutzeroberflächenelemente verwenden sollte, die der Handler möglicherweise anzeigen muss. Wenn FOF_SILENT im Vorgang angegeben wird, sollte die Methode diesen Parameter ignorieren.

Operation [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. Bei diesem Parameter kann es sich um einen oder mehrere der Werte handeln, die unter dem fFlags-Member der SHFILEOPSTRUCT-Struktur aufgeführt sind.

Bei Druckerkopierhaken 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 verweist 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. Darf nicht verwendet werden.
PO_REN_PORT	Wird nicht unterstützt. Darf nicht verwendet werden.

srcFile [in]: Ein Zeiger auf eine Zeichenfolge, die den Namen des Quellordners enthält.

srcAttribs [in]

Die Attribute des Quellordners. Bei diesem Parameter kann es sich um eine Kombination beliebiger Dateiattributeflags (FILE_ATTRIBUTE_*) handelt, die in den Headerdateien definiert sind. Weitere Informationen finden Sie unter Dateiattributekonstanten.

destFile [in]

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

destAttribs [in]

Die Attribute des Zielordners. Bei diesem Parameter kann es sich um eine Kombination beliebiger Dateiattributeflags (FILE_ATTRIBUTE_*) handelt, die in den Headerdateien definiert sind. Weitere Informationen finden Sie unter Dateiattributekonstanten.

Ergebnis [out]

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

Wert	BESCHREIBUNG
IDYES	Ermöglicht den Vorgang.
IDNO	Verhindert den Vorgang für diesen Ordner, wird aber mit allen anderen Vorgängen fortgesetzt, die genehmigt wurden (z. B. ein Batchkopiervorgang).
IDCANCEL	Verhindert den aktuellen Vorgang und bricht alle ausstehenden Vorgänge ab.

Rückgabewert

Gibt bei erfolgreicher Ausführung S_OK oder andernfalls einen Fehlercode zurück.

Bemerkungen

Die Shell ruft den Copy Hook-Handler des Cloudanbieters für jeden Ordner unter dem registrierten Synchronisierungsstamm auf. Um einen Kopierhookhandler für Cloudordner zu registrieren, legen Sie den CopyHook-Wert unter dem Schlüssel HKEY_LOCAL_MACHINE/Software/Microsoft/Windows/CurrentVersion/Explorer/SyncRootManager/{SyncRootId} auf die CLSID des Kopierhookobjekts 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 einer Cloudsynchronisierungs-Engine, die Platzhalterdateien unterstützt

Freigeben über