Freigeben über

CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAGS Enumeration (cfapi.h)

Flags zum Angeben des Verhaltens beim Übertragen einer Platzhalterdatei oder eines Verzeichnisses.

Syntax

typedef enum CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAGS {
  CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_NONE = 0x00000000,
  CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_STOP_ON_ERROR = 0x00000001,
  CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_DISABLE_ON_DEMAND_POPULATION = 0x00000002
} ;

Konstanten

 
CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_NONE
Wert: 0x00000000
Keine Übertragungsplatzhalterkennzeichnungen.
CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_STOP_ON_ERROR
Wert: 0x00000001
Führt dazu, dass die API sofort zurückgegeben wird, wenn eine Platzhalterübertragung fehlschlägt. Wenn eine Übertragung fehlschlägt, wird der Fehlercode zurückgegeben.
CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_DISABLE_ON_DEMAND_POPULATION
Wert: 0x00000002
Deaktiviert die On-Demand-Population für das Verzeichnis und verhindert weitere CF_CALLBACK_TYPE_FETCH_PLACEHOLDERS Rückrufe.

WICHTIG

Ohne dieses Kennzeichen wird der Rückruf der Übertragungsplatzhalter wiederholt (potenziell 100 Mal) aufgerufen, da das System weiterhin Platzhalter bei Bedarf anfordert. Anbieter sollten dieses Kennzeichen festlegen, um anzugeben, dass alle Platzhalter erstellt wurden und keine weiteren Rückrufe erforderlich sind.

Wenn der Anbieter das Erstellen aller Platzhalter in einem Verzeichnis abgeschlossen hat, sollte es das Verzeichnis als vollständig ausgefüllt markieren, indem das CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_DISABLE_ON_DEMAND_POPULATION-Flag festgelegt wird. Dadurch wird verhindert, dass der CF_CALLBACK_TYPE_FETCH_PLACEHOLDERS Rückruf für dieses Verzeichnis erneut aufgerufen wird. In der Regel sollte ein Anbieter dieses Flag festlegen, nachdem er alle Platzhalter im Verzeichnis festgelegt hat, oder wenn der aktuelle Aufruf von CF_OPERATION_TYPE_TRANSFER_PLACEHOLDERS alle verbleibenden Platzhalter erstellen soll.

Der Anbieter kann dieses Kennzeichen jederzeit festlegen und wird von der Plattform berücksichtigt, wenn während des aktuellen Aufrufs von CF_OPERATION_TYPE_TRANSFER_PLACEHOLDERS:

1. TransferPlaceholders.PlaceholderTotalCount<= (Summe der vorherigen TransferPlaceholders.EntriesProcessed) + Aktueller TransferPlaceholders.PlaceholderCount.
1. Alle aktuellen TransferPlaceholders.PlaceholderCount Platzhalter werden erfolgreich erstellt.

Wenn beispielsweise ein Anbieter zehn Platzhalter übertragen muss, kann er CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_DISABLE_ON_DEMAND_POPULATION auf eine der folgenden Arten übertragen und festlegen.

Dies könnte folgendes tun:

1. FestlegenTransferPlaceholders.PlaceholderTotalCount5 = , Festlegen4 = TransferPlaceholders.PlaceholderCount und Festlegen Flags auf .NONE
1. FestlegenTransferPlaceholders.PlaceholderTotalCount9 = , Festlegen4 = TransferPlaceholders.PlaceholderCount und Festlegen Flags auf .NONE
1. FestlegenTransferPlaceholders.PlaceholderTotalCount11 = , Festlegen2 = TransferPlaceholders.PlaceholderCount und Festlegen Flags auf .NONE
1. FestlegenTransferPlaceholders.PlaceholderTotalCount10 = , Festlegen0 = TransferPlaceholders.PlaceholderCount und Festlegen Flags auf .CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_DISABLE_ON_DEMAND_POPULATION

Oder dies kann wie folgt aussehen:

1. FestlegenTransferPlaceholders.PlaceholderTotalCount5 = , Festlegen4 = TransferPlaceholders.PlaceholderCount und Festlegen Flags auf .NONE
1. FestlegenTransferPlaceholders.PlaceholderTotalCount9 = , Festlegen4 = TransferPlaceholders.PlaceholderCount und Festlegen Flags auf .NONE
1. FestlegenTransferPlaceholders.PlaceholderTotalCount10 = , Festlegen2 = TransferPlaceholders.PlaceholderCount und Festlegen Flags auf .CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_DISABLE_ON_DEMAND_POPULATION

Anforderungen

Anforderung Wert
Mindestens unterstützter Client Windows 10, Version 1709 [nur Desktop-Apps]
Mindestanforderungen für unterstützte Server Windows Server 2016 [nur Desktop-Apps]
Header cfapi.h

Siehe auch

CF_CALLBACK_TYPE

CF_OPERATION_TYPE

CfExecute

  • Last updated on