Структура CUSTOM_FIELD_DEFINITION
Содержит сведения о схеме, определяющие пользовательское поле элемента в хранилище метаданных.
typedef struct _CUSTOM_FIELD_DEFINITION
{
WCHAR wszFieldName[129];
SYNC_METADATA_FIELD_TYPE ulFieldType;
ULONG ulFieldSize;
} CUSTOM_FIELD_DEFINITION;
Элементы
- wszFieldName
Имя поля. Максимальная длина составляет 128 символов, включая нулевой завершающий символ.
- ulFieldType
Тип данных поля.
- ulFieldSize
Максимальная длина для полей переменной длины, например строкового или байтового массива. Это значение не учитывается для типов с фиксированной длиной.
Замечания
В метаданных для элемента может быть определен набор настраиваемых полей. Каждое поле состоит из уникального строкового имени и значения. Эти поля можно использовать для хранения любых дополнительных метаданных об элементе, которые не поддерживаются в стандартном наборе метаданных для элемента. Доступ к полям производится через различные методы интерфейса IItemMetadata, например IItemMetadata::TryGetFieldByteArray или IItemMetadata::SetFieldByteArray. Эти поля и их формат (включая размер и тип данных) определяются при инициализации хранилища метаданных для реплики при помощи метода ISyncMetadataStore::InitializeReplicaMetadata.
В схеме содержится длина значения поля. Для полей фиксированной длины это значение представляет собой размер типа данных в байтах. Для полей переменной длины это значение определяет максимальную длину поля в байтах, если поле представляет собой байтовый массив, или в символах, если поле представляет собой строку.
Специальные вопросы применения реализации, предоставленной службой хранения метаданных
На имена полей накладываются следующие ограничения.
Имена полей должны быть уникальными в пределах набора определений полей
Первый символ имени должен быть либо буквой (согласно стандарту Юникод, например, A – Z или a – z), либо символом подчеркивания (_).
Последующие символы в имени могут быть буквами, десятичными цифрами или одним из следующих символов: _@#$.
Имена не должны содержать пробелы, символы табуляции и другие специальные символы.
Имена не должны совпадать с зарезервированными словами Transact-SQL.
Хранилище метаданных также налагает определенные ограничения на размер значений полей. Совокупный размер каждой записи метаданных не может превышать 8 060 байт. Размер файла хранилища метаданных ограничен величиной 4 ГБ.
Системные требования
Заголовок: Metastore.h