Funzione CfSetCorrelationVector (cfapi.h)

Consente a un provider di sincronizzazione di indicare alla piattaforma di usare un vettore di correlazione specifico per scopi di telemetria in un file segnaposto. Operazione facoltativa.

Sintassi

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

Parametri

[in] FileHandle

Handle per il file segnaposto. La piattaforma sincronizza correttamente l'operazione con altre richieste attive. Un attributo o un handle di accesso non è sufficiente.

[in] CorrelationVector

Vettore di correlazione specifico da associare a FileHandle.

Valore restituito

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

La piattaforma assegna automaticamente un vettore di correlazione a ogni file quando viene aperto e fornisce questo vettore di correlazione con ogni callback al provider di sincronizzazione come parte del CF_CALLBACK_INFO comune. È consigliabile che il motore di sincronizzazione chiami questa funzione per incrementare l'ultima cifra del vettore di correlazione "clock" in quanto il provider di sincronizzazione procede attraverso fasi interne (come definito dal provider di sincronizzazione) per soddisfare la richiesta.

Requisiti

Vedi anche

CF_CALLBACK_INFO