CF_OPERATION_INFO 結構 (cfapi.h)

佔位元檔案或資料夾上的作業相關信息。

語法

typedef struct CF_OPERATION_INFO {
  ULONG                    StructSize;
  CF_OPERATION_TYPE        Type;
  CF_CONNECTION_KEY        ConnectionKey;
  CF_TRANSFER_KEY          TransferKey;
  const CORRELATION_VECTOR *CorrelationVector;
  const CF_SYNC_STATUS     *SyncStatus;
  CF_REQUEST_KEY           RequestKey;
} CF_OPERATION_INFO;

成員

StructSize

CF_OPERATION_INFO 結構的大小。

Type

正在執行的作業類型。 如需詳細資訊 ，請參閱CF_OPERATION_TYPE 。

ConnectionKey

為通道取得的連接金鑰。

TransferKey

佔位元的不透明句柄。

CorrelationVector

用於遙測用途之佔位元元上的相互關聯向量。

SyncStatus

平臺目前的 CF_SYNC_STATUS 。

平臺會在雲端檔案佔位元上的任何失敗作業上查詢此資訊。 如果有結構可用，平臺會使用提供的資訊來建構更有意義的且可採取動作的訊息給使用者。 平臺會在檔案上保留這項資訊，直到檔案上的最後一個句柄消失為止。 如果 SyncStatus 為 null，平臺將會清除先前設定的同步處理狀態，如果有同步處理狀態。

RequestKey

不透明標識符，可唯一識別特定雲端檔案上的雲端檔案作業。

備註

平臺會將 ConnectionKey、 TransferKey 和 CorrelationVector 提供給透過 CfConnectSyncRoot 註冊的所有回呼函式。 此外，同步提供者可以使用 CfGetTransferKey 取得 TransferKey，並使用 CfGetCorrelationVector 取得 CorrelationVector。

規格需求

另請參閱

CF_OPERATION_TYPE

CfConnectSyncRoot

CfGetTransferKey

CfGetCorrelationVector

CfExecute

CF_SYNC_STATUS