cfGetCorrelationVector 函式 (cfapi.h)

允許同步提供者查詢指定佔位符檔案的目前相互關聯向量。這會是平臺第一次開啟檔案時自動指派的檔案，或透過 CfSetCorrelationVector 明確指派的檔案。

語法

HRESULT CfGetCorrelationVector(
  [in]  HANDLE              FileHandle,
  [out] PCORRELATION_VECTOR CorrelationVector
);

[in] FileHandle

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

[out] CorrelationVector

目前與 FileHandle 相關聯的相互關聯向量。

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

呼叫端 必須具有READ_DATA 或 WRITE_DAC 存取要凍結的佔位元。否則，作業將會因為 STATUS_CLOUD_FILE_ACCESS_DENIED而失敗。