Freigeben über

CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAGS-Enumeration (cfapi.h)

  • Artikel

Flags, um das Verhalten beim Übertragen einer Platzhalterdatei oder eines Verzeichnisses anzugeben.

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 Transferplatzhalterflags.
CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_STOP_ON_ERROR
Wert: 0x00000001
Bewirkt, dass die API sofort zurückgegeben wird, wenn eine Platzhalterübertragung fehlschlägt. Wenn bei einer Übertragung ein Fehler auftritt, wird der Fehlercode zurückgegeben.
CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_DISABLE_ON_DEMAND_POPULATION
Wert: 0x00000002
Wenn der Anbieter nicht mehr möchte, dass sein CF_CALLBACK_TYPE_FETCH_PLACEHOLDERS Rückruf aufgerufen wird, sollte er das Platzhalterverzeichnis vollständig aufgefüllt markieren, indem er das CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_DISABLE_ON_DEMAND_POPULATION-Flag in CF_OPERATION_TYPE_TRANSFER_PLACEHOLDERS festlegt. In der Regel sollte ein Anbieter dieses Flag festlegen, nachdem er bereits alle Platzhalter im Verzeichnis festgelegt hat, oder wenn der aktuelle Aufruf von CF_OPERATION_TYPE_TRANSFER_PLACEHOLDERS alle Platzhalter festlegen soll. Der Anbieter kann dieses Flag jederzeit festlegen, und es würde von der Plattform berücksichtigt werden, wenn während des aktuellen Aufrufs von CF_OPERATION_TYPE_TRANSFER_PLACEHOLDERS:

1. TransferPlaceholders.PlaceholderTotalCount<= (Summe von Prior TransferPlaceholders.EntriesProcessed) + Current TransferPlaceholders.PlaceholderCount.
2. Alle aktuellen TransferPlaceholders.PlaceholderCount Platzhalter wurden erfolgreich erstellt.

Wenn ein Anbieter beispielsweise 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. Legen Sie TransferPlaceholders.PlaceholderTotalCount5 = fest , TransferPlaceholders.PlaceholderCount = 4und legen Sie auf NONEfest.Flags
2. Legen Sie TransferPlaceholders.PlaceholderTotalCount9 = fest , TransferPlaceholders.PlaceholderCount = 4und legen Sie auf NONEfest.Flags
3. Legen Sie TransferPlaceholders.PlaceholderTotalCount = 11fest , und TransferPlaceholders.PlaceholderCount2 = legen Sie auf NONEfest.Flags
4. Legen Sie TransferPlaceholders.PlaceholderTotalCount = 10fest , und TransferPlaceholders.PlaceholderCount0 = legen Sie auf CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_DISABLE_ON_DEMAND_POPULATIONfest.Flags

Oder es kann die folgenden Aktionen ausführen:

1. Legen Sie TransferPlaceholders.PlaceholderTotalCount5 = fest , TransferPlaceholders.PlaceholderCount = 4und legen Sie auf NONEfest.Flags
2. Legen Sie TransferPlaceholders.PlaceholderTotalCount9 = fest , TransferPlaceholders.PlaceholderCount = 4und legen Sie auf NONEfest.Flags
3. Legen Sie TransferPlaceholders.PlaceholderTotalCount = 10fest , und TransferPlaceholders.PlaceholderCount2 = legen Sie auf CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_DISABLE_ON_DEMAND_POPULATIONfest.Flags

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10, Version 1709 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2016 [nur Desktop-Apps]
Kopfzeile cfapi.h

Weitere Informationen

CF_CALLBACK_TYPE

CF_OPERATION_TYPE

CfExecute