Share via

IItemMetadata::TryGetFieldUInt64

  • Article

Gets the value of a 64-bit unsigned integer field.

Syntax

HRESULT TryGetFieldUInt64(
  LPCWSTR pcszFieldName,
  ULONGLONG * pValue);

Parameters

  • pcszFieldName
    [in, string] The name of the field.

  • pValue
    [out] Returns the value of the specified field.

Return Value

  • S_OK

  • S_FALSE if the value has not been set.

  • E_POINTER

  • E_INVALIDARG

  • SYNC_E_METADATA_FIELD_INVALID_NAME if the field does not exist.

  • SYNC_E_METADATA_FIELD_INVALID_TYPE if the field is not a 64-bit unsigned integer.

Remarks

Custom fields must be defined by using a CUSTOM_FIELD_DEFINITION structure when the replica metadata is first initialized.

If IItemMetadata::SetFieldUInt64 was called to set the field value, but the change has not yet been saved by a call to IReplicaMetadata::SaveItemMetadata, TryGetFieldUInt64 returns the value that is contained in the IItemMetadata object and not the value that is stored in the metadata store.

See Also

Reference

IItemMetadata Interface