IItemMetadata::TryGetFieldUInt8
8 ビットの符号なし整数フィールドの値を取得します。
構文
HRESULT TryGetFieldUInt8(
LPCWSTR pcszFieldName,
BYTE * pbValue);
パラメーター
pcszFieldName
[in, string] フィールドの名前。pbValue
[out] 指定したフィールドの値を返します。
戻り値
S_OK
値が設定されていない場合は S_FALSE。
E_POINTER
E_INVALIDARG
フィールドが存在しない場合は SYNC_E_METADATA_FIELD_INVALID_NAME。
フィールドが 8 ビットの符号なし整数型でない場合は SYNC_E_METADATA_FIELD_INVALID_TYPE。
説明
カスタム フィールドは、レプリカ メタデータを初めて初期化するときに、CUSTOM_FIELD_DEFINITION 構造体を使用して定義する必要があります。
フィールド値を設定するために IItemMetadata::SetFieldUInt8 を呼び出した場合、IReplicaMetadata::SaveItemMetadata の呼び出しによって変更がまだ保存されていなければ、TryGetFieldUInt8 はメタデータ ストアに保存されている値ではなく、IItemMetadata オブジェクトに格納されている値を返します。