Compartir a través de


Función CfSetCorrelationVector (cfapi.h)

Permite a un proveedor de sincronización indicar a la plataforma que use un vector de correlación específico con fines de telemetría en un archivo de marcador de posición. Esto es opcional.

Sintaxis

HRESULT CfSetCorrelationVector(
  [in] HANDLE                    FileHandle,
  [in] const PCORRELATION_VECTOR CorrelationVector
);

Parámetros

[in] FileHandle

Identificador del archivo de marcador de posición. La plataforma sincroniza correctamente la operación con otras solicitudes activas. Un atributo o identificador sin acceso es suficiente.

[in] CorrelationVector

Vector de correlación específico que se va a asociar con FileHandle.

Valor devuelto

Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

La plataforma asigna automáticamente un vector de correlación a cada archivo cuando se abre por primera vez y proporciona este vector de correlación con cada devolución de llamada al proveedor de sincronización como parte de la CF_CALLBACK_INFO común. Se recomienda que el motor de sincronización llame a esta función para incrementar el último dígito del vector de correlación "reloj" a medida que el proveedor de sincronización avanza a través de las fases internas (según lo define el proveedor de sincronización) de satisfacer la solicitud.

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

Consulte también

CF_CALLBACK_INFO