CUSTOM_FIELD_DEFINITION 結構
包含結構描述資訊，該資訊會定義中繼資料存放區內之項目的自訂欄位。
typedef struct _CUSTOM_FIELD_DEFINITION
{
WCHAR wszFieldName[129];
SYNC_METADATA_FIELD_TYPE ulFieldType;
ULONG ulFieldSize;
} CUSTOM_FIELD_DEFINITION;
成員
- wszFieldName
欄位的名稱。最大長度為 128 個字元加上 Null 結束字元。
- ulFieldType
欄位的資料類型。
- ulFieldSize
可變長度欄位 (例如字串或位元組陣列) 的最大長度。固定長度型別會忽略這個值。
備註
您可以針對項目中繼資料定義一組自訂欄位，每一個欄位都是由唯一的字串名稱和值所組成。這些欄位可用來存放有關預設項目中繼資料集合所不支援之項目的任何其他中繼資料。這些欄位可透過 IItemMetadata 上的各種方法 (如 IItemMetadata::TryGetFieldByteArray 或 IItemMetadata::SetFieldByteArray) 來存取。當使用 ISyncMetadataStore::InitializeReplicaMetadata 來為複寫初始化中繼資料存放區時，會定義這些欄位和其格式 (包括大小和資料型別)。
此結構描述包含欄位值的長度。如果是固定長度的欄位，這個值就是資料型別的大小 (以位元組為單位)。如果是可變長度欄位，這個值就會指定欄位的最大長度 (位元組陣列以位元組為單位，字串則以字元為單位)。
使用 Metadata Storage Service 提供之實作時的特殊考量
欄位名稱必須遵守下列限制。
欄位名稱在欄位定義集合內必須是唯一的
名稱的第一個字元必須是字母 (如 Unicode 標準所定義，例如 A-Z 或 a-z) 或底線 (_)。
名稱中的後續字元可以是字母、十進位數字，或下列其中一個符號：_@#$。
名稱不可包含內嵌空格、Tab 字元或任何其他特殊字元。
名稱不可與任何 Transact-SQL 保留字相同。
中繼資料存放區也有一些會影響欄位值的大小限制。每個項目中繼資料項目的總計大小限制為 8060 位元組。中繼資料存放區檔案則限制為 4GB。
需求
標頭： Metastore.h