Compartilhar via


Função CfGetCorrelationVector (cfapi.h)

Permite que o provedor de sincronização consulte o vetor de correlação atual para um determinado arquivo de espaço reservado. Esse será o atribuído automaticamente pela plataforma quando o arquivo for aberto pela primeira vez ou atribuído explicitamente por meio de CfSetCorrelationVector.

Sintaxe

HRESULT CfGetCorrelationVector(
  [in]  HANDLE              FileHandle,
  [out] 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.

[out] CorrelationVector

O vetor de correlação atualmente 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

O chamador deve ter READ_DATA ou WRITE_DAC acesso ao espaço reservado para ser hidratado. Caso contrário, a operação falhará com STATUS_CLOUD_FILE_ACCESS_DENIED.

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

CfSetCorrelationVector