Structure CUSTOM_FIELD_DEFINITION
Contient des informations de schéma qui définissent un champ personnalisé d'un élément dans le magasin des métadonnées.
typedef struct _CUSTOM_FIELD_DEFINITION
{
WCHAR wszFieldName[129];
SYNC_METADATA_FIELD_TYPE ulFieldType;
ULONG ulFieldSize;
} CUSTOM_FIELD_DEFINITION;
Membres
- wszFieldName
Nom du champ. La longueur maximale est de 128 caractères, plus la marque de fin null.
- ulFieldType
Type de données du champ.
- ulFieldSize
Longueur maximale du champ pour les champs de longueur variable, comme une chaîne ou un tableau d'octets. Cette valeur est ignorée pour les types de longueur fixe.
Notes
Un ensemble de champs personnalisés peut être défini pour les métadonnées d'élément. Chaque champ consiste en un nom de chaîne unique et une valeur. Ces champs peuvent être utilisés pour stocker des métadonnées supplémentaires concernant un élément qui n'est pas pris en charge par l'ensemble par défaut de métadonnées d'élément. Les champs sont accessibles via différentes méthodes sur IItemMetadata, comme IItemMetadata::TryGetFieldByteArray ou IItemMetadata::SetFieldByteArray. Ces champs et leur format, y compris la taille et le type de données, sont définis lorsque le magasin des métadonnées est initialisé pour un réplica à l'aide de ISyncMetadataStore::InitializeReplicaMetadata.
Le schéma contient la longueur pour la valeur du champ. Pour les champs de longueur fixe, cette valeur représente la taille du type de données en octets. Pour les champs de longueur variable, cette valeur spécifie la longueur maximale du champ, en octets pour un tableau d'octets ou en caractères pour une chaîne.
Considérations spéciales lors de l'utilisation de l'implémentation fournie par le Metadata Storage Service
Les noms de champ doivent se conformer aux restrictions suivantes.
Les noms de champ doivent être uniques dans l'ensemble de définitions de champ.
Le premier caractère du nom doit être une lettre (comme défini par le standard Unicode, par exemple A-Z ou a-z) ou un trait de soulignement (_).
Les caractères suivants du nom peuvent être des lettres, des nombres décimaux ou un de ces symboles : _@#$.
Les noms ne peuvent pas contenir d'espaces incorporés, de tabulations ou d'autres caractères spéciaux.
Les noms ne doivent être identiques à aucun mot réservé Transact-SQL.
Le magasin des métadonnées impose également certaines limites de taille qui affectent les valeurs de champ. La taille totale de chaque entrée de métadonnées d'élément est limitée à 8 060 octets. Le fichier de magasin des métadonnées est limité à 4 Go.
Spécifications
En-tête : Metastore.h