通过

IItemMetadata::SetFieldByteArray

  • 项目

设置字节数组字段的值。

HRESULT SetFieldByteArray(
  LPCWSTR pcszFieldName,
  BYTE * pbValue,
  ULONG cbValue);

参数

  • pcszFieldName
    [in, string] 字段的名称。
  • pbValue
    [in, unique, size_is(cbValue)] 字段的值。
  • cbValue
    [in] pbValue 中的字节数。

返回值

  • S_OK。

  • E_POINTER。

  • E_INVALIDARG。

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

  • 如果字段不属于字节数组类型，则返回值为 SYNC_E_METADATA_FIELD_INVALID_TYPE。

备注

通过为 pbValue 指定 NULL 和为 cbValue 指定 0，可以将字段值重置为空值。如果 pbValue 设置为 NULL 但 cbValue 不为 0，或者如果 cbValue 为 0 但 pbValue 不为 NULL，则返回 E_INVALIDARG。

备注

此方法不会将变更保存到存储区中。必须通过调用 IReplicaMetadata::SaveItemMetadata 才能保存对 IItemMetadata 属性所做的全部变更。

请参阅

参考

IItemMetadata 接口