Partager via

énumération CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAGS (cfapi.h)

  • Article

Indicateurs pour spécifier le comportement lors du transfert d’un fichier ou d’un répertoire d’espace réservé.

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
} ;

Constantes

 
CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_NONE
Valeur : 0x00000000
Aucun indicateur d’espace réservé de transfert.
CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_STOP_ON_ERROR
Valeur : 0x00000001
Provoque le retour immédiat de l’API en cas d’échec d’un transfert d’espace réservé. Si un transfert échoue, le code d’erreur est retourné.
CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_DISABLE_ON_DEMAND_POPULATION
Valeur : 0x00000002
Si le fournisseur ne souhaite plus que son rappel CF_CALLBACK_TYPE_FETCH_PLACEHOLDERS soit appelé, il doit marquer le répertoire d’espace réservé entièrement rempli en définissant l’indicateur CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_DISABLE_ON_DEMAND_POPULATION dans CF_OPERATION_TYPE_TRANSFER_PLACEHOLDERS. En règle générale, un fournisseur doit définir cet indicateur après avoir déjà défini tous les espaces réservés dans le répertoire, ou si l’appel actuel de CF_OPERATION_TYPE_TRANSFER_PLACEHOLDERS est censé poser tous les espaces réservés. Le fournisseur peut définir cet indicateur à tout moment et il serait respecté par la plateforme si pendant l’appel actuel de CF_OPERATION_TYPE_TRANSFER_PLACEHOLDERS :

1. TransferPlaceholders.PlaceholderTotalCount<= (Somme des précédents TransferPlaceholders.EntriesProcessed) + actuel TransferPlaceholders.PlaceholderCount.
2. Tous les espaces réservés actuels TransferPlaceholders.PlaceholderCount sont créés avec succès.

Par exemple, si un fournisseur doit transférer dix espaces réservés, il peut transférer et définir CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_DISABLE_ON_DEMAND_POPULATION de l’une des manières suivantes.

Il peut effectuer les tâches suivantes :

1. Définissez TransferPlaceholders.PlaceholderTotalCount = 5, définissez TransferPlaceholders.PlaceholderCount4 = et définissez Flags sur .NONE
2. Définissez , et TransferPlaceholders.PlaceholderCount4 = définissez TransferPlaceholders.PlaceholderTotalCount9 = Flags sur .NONE
3. Définissez , et TransferPlaceholders.PlaceholderCount2 = définissez TransferPlaceholders.PlaceholderTotalCount11 = Flags sur .NONE
4. Définissez , et TransferPlaceholders.PlaceholderCount0 = définissez TransferPlaceholders.PlaceholderTotalCount10 = Flags sur .CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_DISABLE_ON_DEMAND_POPULATION

Il peut également effectuer les opérations suivantes :

1. Définissez TransferPlaceholders.PlaceholderTotalCount = 5, définissez TransferPlaceholders.PlaceholderCount4 = et définissez Flags sur .NONE
2. Définissez , et TransferPlaceholders.PlaceholderCount4 = définissez TransferPlaceholders.PlaceholderTotalCount9 = Flags sur .NONE
3. Définissez , et TransferPlaceholders.PlaceholderCount2 = définissez TransferPlaceholders.PlaceholderTotalCount10 = Flags sur .CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_DISABLE_ON_DEMAND_POPULATION

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 10, version 1709 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2016 (applications de bureau uniquement)
En-tête cfapi.h

Voir aussi

CF_CALLBACK_TYPE

CF_OPERATION_TYPE

CfExecute