cfSetCorrelationVector 函数 (cfapi.h)

允许同步提供程序指示平台在占位符文件上使用特定的相关向量进行遥测。此为可选项。

语法

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

[in] FileHandle

占位符文件的句柄。平台将操作与其他活动请求正确同步。属性或无访问句柄就足够了。

[in] CorrelationVector

要与 FileHandle 关联的特定相关向量。

如果此函数成功，则返回 S_OK。否则，将返回 HRESULT 错误代码。

平台在首次打开每个文件时自动为其分配相关向量，并在公共 CF_CALLBACK_INFO中向同步提供程序的每个回调提供此相关向量。建议同步引擎调用此函数来递增相关向量“时钟”的最后一位数，因为同步提供程序) 在满足请求) 同步提供程序定义的内部 (阶段。