Função CfSetCorrelationVector (cfapi.h)

Permite que um provedor de sincronização instrua a plataforma a usar um vetor de correlação específico para fins de telemetria em um arquivo de espaço reservado. Isso é opcional.

Sintaxe

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

Parâmetros

[in] FileHandle

O identificador para o arquivo de espaço reservado. A plataforma sincroniza corretamente a operação com outras solicitações ativas. Um identificador de atributo ou sem acesso é suficiente.

[in] CorrelationVector

Um vetor de correlação específico a ser associado ao FileHandle.

Retornar valor

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

A plataforma atribui automaticamente um vetor de correlação a cada arquivo quando ele é aberto pela primeira vez e fornece esse vetor de correlação com cada retorno de chamada para o provedor de sincronização como parte do CF_CALLBACK_INFO comum. É recomendável que o mecanismo de sincronização chame essa função para incrementar o último dígito do "relógio" do vetor de correlação à medida que o provedor de sincronização progride por meio de estágios internos (conforme definido pelo provedor de sincronização) de atender à solicitação.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 10, versão 1709 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2016 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	cfapi.h
Biblioteca	CldApi.lib
DLL	CldApi.dll

Confira também

CF_CALLBACK_INFO