通过

CUSTOM_FIELD_DEFINITION 结构

  • 项目

包含为元数据存储区中的项定义自定义字段的架构信息。

typedef struct _CUSTOM_FIELD_DEFINITION
{
  WCHAR wszFieldName[129];
  SYNC_METADATA_FIELD_TYPE ulFieldType;
  ULONG ulFieldSize;
} CUSTOM_FIELD_DEFINITION;

成员

  • wszFieldName
    字段的名称。包括 null 终止符在内，最大长度为 128 个字符。
  • ulFieldType
    字段的数据类型。
  • ulFieldSize
    可变长度字段（如字符串或字节数组）的最大字段长度。对于固定长度的类型，将忽略此值。

备注

可为项元数据定义一组自定义字段。每个字段均由一个唯一的字符串名称和一个值组成。这些字段可用于存储项的默认元数据集不支持的任何其他元数据。可以通过 IItemMetadata 的各种方法（如 IItemMetadata::TryGetFieldByteArray 或 IItemMetadata::SetFieldByteArray）访问这些字段。这些字段及其格式（包括大小和数据类型）是在使用 ISyncMetadataStore::InitializeReplicaMetadata 初始化副本的元数据存储区时定义的。

架构包含字段值的长度。对于固定长度字段，此值为数据类型的大小（以字节为单位）。对于可变长度字段，此值指定字段的最大长度，当字段为字节数组时以字节为单位，当字段为字符串时以字符为单位。

使用 Metadata Storage Service 提供的实现时应注意的特殊注意事项

字段名称必须遵循以下限制。

  • 字段名称在字段定义集中必须唯一

  • 名称的第一个字符必须为字母（按 Unicode 标准定义的，例如 A-Z 或 a-z）或者下划线 (_)。

  • 名称中的后续字符可以为字母、十进制数字或以下符号之一：_@#$。

  • 名称不能包含嵌入空格、制表符或任何其他特殊字符。

  • 名称不能与任何 Transact-SQL 保留字相同。

元数据存储区还会强加影响字段值的特定大小限制。每个项元数据条目的总大小不得超过 8060 字节。元数据存储文件不得超过 4GB。

要求

**头文件：**Metastore.h

请参阅

概念

Sync Framework Metadata Storage Service 组件