CfExecute, fonction (cfapi.h)

Point d’entrée main pour toutes les opérations d’espace réservé basés sur une clé de connexion. Il est destiné à être utilisé par un fournisseur de synchronisation pour répondre à différents rappels à partir de la plateforme.

Syntaxe

HRESULT CfExecute(
  [in]      const CF_OPERATION_INFO *OpInfo,
  [in, out] CF_OPERATION_PARAMETERS *OpParams
);

Paramètres

[in] OpInfo

Informations sur une opération sur un espace réservé.

[in, out] OpParams

Paramètres d’une opération sur un espace réservé.

Valeur retournée

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Un appel valide à CfExecute réinitialise les minuteurs de toutes les demandes de rappel en attente qui appartiennent au même processus de fournisseur de synchronisation.

CfExecute prend deux arguments de taille variable, c’est-à-dire CF_OPERATION_INFO et CF_OPERATION_PARAMETERS, l’un identifiant le type d’opération et l’autre fournissant des paramètres d’opération détaillés. Les deux arguments commencent par un champ StructSize au début des structures correspondantes. Les appelants de CfExecute sont responsables de la comptabilité précise de la taille de la structure.

La plateforme fournit ConnectionKey, TransferKey et CorrelationVector à toutes les fonctions de rappel inscrites auprès de CfConnectSyncRoot. En outre, les fournisseurs de synchronisation peuvent obtenir TransferKey à l’aide de CfGetTransferKey et correlationVector à l’aide de CfGetCorrelationVector.

Si vous le souhaitez, les fournisseurs de synchronisation peuvent fournir une synchronisation status objet blob à la plateforme. Si un pointeur non null est défini dans le champ SyncStatus dans CF_OPERATION_INFO, son contenu est conservé sur le fichier jusqu’à ce que le dernier handle sur celui-ci soit supprimé. La plateforme interroge ces informations en cas d’échec d’opérations sur un espace réservé de fichier cloud. Si un message est disponible, la plateforme utilisera les informations fournies pour créer un message plus explicite et exploitable pour l’utilisateur.

Si un pointeur null est défini dans le champ SyncStatus dans CF_OPERATION_INFO, la plateforme efface le status de synchronisation précédemment défini (le cas échéant).

Toutes les opérations peuvent être effectuées dans un contexte de thread arbitraire dans le processus du fournisseur de synchronisation.

Configuration requise

Voir aussi

CfConnectSyncRoot

CfGetCorrelationVector

CF_OPERATION_INFO

CF_OPERATION_PARAMETERS