Función CfExecute (cfapi.h)
Punto de entrada principal para todas las operaciones de marcador de posición basadas en claves de conexión. Está pensado para que un proveedor de sincronización responda a varias devoluciones de llamada de la plataforma.
Sintaxis
HRESULT CfExecute(
[in] const CF_OPERATION_INFO *OpInfo,
[in, out] CF_OPERATION_PARAMETERS *OpParams
);
Parámetros
[in] OpInfo
Información sobre una operación en un marcador de posición.
[in, out] OpParams
Parámetros de una operación en un marcador de posición.
Valor devuelto
Si esta función se ejecuta correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.
Comentarios
Una llamada válida a CfExecute restablecerá los temporizadores de todas las solicitudes de devolución de llamada pendientes que pertenecen al mismo proceso del proveedor de sincronización.
CfExecute toma dos argumentos de tamaño variable, es decir, CF_OPERATION_INFO y CF_OPERATION_PARAMETERS, con uno que identifica el tipo de operación y el otro proporcionando parámetros de operación detallados. Ambos argumentos comienzan con un campo StructSize al principio de las estructuras correspondientes. Los autores de llamadas de CfExecute son responsables de una contabilidad precisa del tamaño de la estructura.
La plataforma proporciona ConnectionKey, TransferKey y CorrelationVector a todas las funciones de devolución de llamada registradas con CfConnectSyncRoot. Además, los proveedores de sincronización pueden obtener TransferKey mediante CfGetTransferKey y CorrelationVector mediante CfGetCorrelationVector.
Opcionalmente, los proveedores de sincronización pueden proporcionar un blob de estado de sincronización a la plataforma. Si se establece un puntero distinto de null en el campo SyncStatus de CF_OPERATION_INFO, su contenido se conservará en el archivo hasta que se quite el último identificador de él. La plataforma consultará esta información sobre las operaciones con errores en un marcador de posición de archivo en la nube. Si hay uno disponible, la plataforma usará la información proporcionada para construir un mensaje más significativo y accionable para el usuario.
Si se establece un puntero nulo en el campo SyncStatus de CF_OPERATION_INFO, la plataforma borrará el estado de sincronización establecido anteriormente (si existe).
Todas las operaciones se pueden realizar en un contexto de subproceso arbitrario en el proceso del proveedor de sincronización.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 10, versión 1709 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2016 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | cfapi.h |
| Library | CldApi.lib |
| Archivo DLL | CldApi.dll |