CfSetCorrelationVector 函式 (cfapi.h)

允許同步提供者指示平臺針對佔位符檔案上的遙測用途使用特定的相互關聯向量。這是選擇性的。

語法

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

[in] FileHandle

佔位元檔案的句柄。平臺會正確同步處理作業與其他作用中要求。屬性或無存取句柄已足夠。

[in] CorrelationVector

要與 FileHandle 相關聯的特定相互關聯向量。

如果函式成功，則會傳 S_OK回。否則，它會傳回 HRESULT 錯誤碼。

平臺會在第一次開啟檔案時，自動將相互關聯向量指派給每個檔案，並提供此相互關聯向量給同步提供者，作為常見 CF_CALLBACK_INFO的一部分。建議同步處理引擎呼叫此函式，以隨著同步提供者在滿足要求) 所定義，在同步提供者進行內部 (階段時遞增相互關聯向量 “clock” 的最後一位數。