Partager via

énumération CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAGS (cfapi.h)

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

Syntaxe

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

Constants

 
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é. En cas d’échec d’un transfert, le code d’erreur est retourné.
CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_DISABLE_ON_DEMAND_POPULATION
Valeur : 0x00000002
Désactive la population à la demande pour l’annuaire, empêchant d’autres CF_CALLBACK_TYPE_FETCH_PLACEHOLDERS rappels.

IMPORTANT

Sans cet indicateur, le rappel des espaces réservés de transfert est appelé à plusieurs reprises (potentiellement 100 fois plus), car le système continue de demander des espaces réservés à la demande. Les fournisseurs doivent définir cet indicateur pour indiquer que tous les espaces réservés ont été créés et qu’aucun rappel supplémentaire n’est nécessaire.

Lorsque le fournisseur a terminé de créer tous les espaces réservés dans un répertoire, il doit marquer le répertoire comme étant entièrement rempli en définissant l’indicateur de CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_DISABLE_ON_DEMAND_POPULATION . Cela empêche le rappel CF_CALLBACK_TYPE_FETCH_PLACEHOLDERS d’être appelé à nouveau pour ce répertoire. En règle générale, un fournisseur doit définir cet indicateur après avoir 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é créer tous les espaces réservés restants.

Le fournisseur peut définir cet indicateur à tout moment et il sera respecté par la plateforme si pendant l’appel actuel de CF_OPERATION_TYPE_TRANSFER_PLACEHOLDERS :

1. TransferPlaceholders.PlaceholderTotalCount<= (Somme de l’avant TransferPlaceholders.EntriesProcessed) + actuel TransferPlaceholders.PlaceholderCount.
1. 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.

Cela peut être le cas :

1. Définissez, définissez TransferPlaceholders.PlaceholderTotalCount5 = et définissez = 4TransferPlaceholders.PlaceholderCount sur .FlagsNONE
1. Définissez, définissez TransferPlaceholders.PlaceholderTotalCount9 = et définissez = 4TransferPlaceholders.PlaceholderCount sur .FlagsNONE
1. Définissez, définissez TransferPlaceholders.PlaceholderTotalCount11 = et définissez = 2TransferPlaceholders.PlaceholderCount sur .FlagsNONE
1. Définissez, définissez TransferPlaceholders.PlaceholderTotalCount10 = et définissez = 0TransferPlaceholders.PlaceholderCount sur .FlagsCF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_DISABLE_ON_DEMAND_POPULATION

Vous pouvez également effectuer les opérations suivantes :

1. Définissez, définissez TransferPlaceholders.PlaceholderTotalCount5 = et définissez = 4TransferPlaceholders.PlaceholderCount sur .FlagsNONE
1. Définissez, définissez TransferPlaceholders.PlaceholderTotalCount9 = et définissez = 4TransferPlaceholders.PlaceholderCount sur .FlagsNONE
1. Définissez, définissez TransferPlaceholders.PlaceholderTotalCount10 = et définissez = 2TransferPlaceholders.PlaceholderCount sur .FlagsCF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_DISABLE_ON_DEMAND_POPULATION

Spécifications

Requirement Valeur
Client minimum requis Windows 10, version 1709 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2016 [applications de bureau uniquement]
Header cfapi.h

Voir aussi

CF_CALLBACK_TYPE

CF_OPERATION_TYPE

CfExecute

  • Last updated on