IItemMetadata::TryGetFieldUInt64

  • [アーティクル]

64 ビットの符号なし整数フィールドの値を取得します。

HRESULT TryGetFieldUInt64(
  LPCWSTR pcszFieldName,
  ULONGLONG * pValue);

パラメーター

  • pcszFieldName
    [in, string] フィールドの名前。
  • pValue
    [out] 指定したフィールドの値を返します。

戻り値

  • S_OK

  • 値が設定されていない場合は S_FALSE。

  • E_POINTER

  • E_INVALIDARG

  • フィールドが存在しない場合は SYNC_E_METADATA_FIELD_INVALID_NAME。

  • フィールドが 64 ビットの符号なし整数型でない場合は SYNC_E_METADATA_FIELD_INVALID_TYPE。

解説

カスタム フィールドは、レプリカ メタデータを初めて初期化するときに、CUSTOM_FIELD_DEFINITION 構造体を使用して定義する必要があります。

フィールド値を設定するために IItemMetadata::SetFieldUInt64 を呼び出した場合、IReplicaMetadata::SaveItemMetadata の呼び出しによって変更がまだ保存されていなければ、TryGetFieldUInt64 はメタデータ ストアに保存されている値ではなく、IItemMetadata オブジェクトに格納されている値を返します。

参照

リファレンス

IItemMetadata インターフェイス