IItemMetadata::TryGetFieldUInt16

获取 16 位无符号整数字段的值。

HRESULT TryGetFieldUInt16(
  LPCWSTR pcszFieldName,
  USHORT * pValue);

参数

  • pcszFieldName
    [in, string] 字段的名称。
  • pValue
    [out] 返回指定字段的值。

返回值

  • S_OK

  • 如果尚未设置值,则返回值为 S_FALSE。

  • E_POINTER

  • E_INVALIDARG

  • 如果字段不存在,则返回值为 SYNC_E_METADATA_FIELD_INVALID_NAME。

  • 如果字段不属于 16 位无符号整数,则返回值为 SYNC_E_METADATA_FIELD_INVALID_TYPE。

备注

首次初始化副本元数据时,必须使用 CUSTOM_FIELD_DEFINITION 结构定义自定义字段。

如果为了设置字段值而调用了 IItemMetadata::SetFieldUInt16,但尚未通过调用 IReplicaMetadata::SaveItemMetadata 来保存该变更,则 TryGetFieldUInt16 会返回包含在 IItemMetadata 对象中的值,而不会返回存储在元数据存储区中的值。

请参阅

参考

IItemMetadata 接口