CF_SYNC_STATUS 構造体 (cfapi.h)

指定した同期ルートの状態を記述するために、 CF_OPERATION_INFO 構造体で使用されます。

構文

typedef struct CF_SYNC_STATUS {
  ULONG StructSize;
  ULONG Code;
  ULONG DescriptionOffset;
  ULONG DescriptionLength;
  ULONG DeviceIdOffset;
  ULONG DeviceIdLength;
} CF_SYNC_STATUS;

メンバー

StructSize

実際の説明文字列を含む同期状態構造のサイズ (バイト単位)。

Code

このパラメーターの使用は、このリッチ同期状態コンストラクトをサポートする同期プロバイダーに完全にかかっています。

特定の同期プロバイダーの場合、コードと説明文字列の間に 1 対 1 のマッピングが存在することが予想されます。

エラー コードの種類 (エラー レベルのコードの場合)、および0情報レベルのコードの場合は1、最上位のビット順を使用することをお勧めします。

DescriptionOffset

CF_SYNC_STATUSの開始位置を基準とした説明文字列のオフセット。 これは、問題のファイルに関するより意味のある実用的な情報を含む、ローカライズされた null で終わるワイド文字列を指します。 同期プロバイダーは、より実用的な情報を提供し、可能な限り小さなメモリ 占有領域を維持するという要件のバランスを取ることが期待されます。

DescriptionLength

null 終端記号を含む説明文字列のサイズ (バイト単位)。

DeviceIdOffset

CF_SYNC_STATUSの開始位置を基準としたデバイス ID BLOB のオフセット。 デバイス ID BLOB はオプションであり、プラットフォームに対して不透明です。 BLOB は、デバイスごとに一意である必要があります。 指定された場合、BLOB はプラットフォーム テレメトリの一部として収集され、技術的な問題の診断に役立ちます。

DeviceIdLength

デバイス ID BLOB のサイズ (バイト単位)。

注釈

CF_OPERATION_INFO構造体の SyncStatus フィールドに null ポインターが設定されている場合、プラットフォームは以前に設定した同期状態 (存在する場合) をクリアします。

要件

こちらもご覧ください

CF_OPERATION_INFO