Estructura CUSTOM_FIELD_DEFINITION

Contiene información de esquema que define un campo personalizado de un elemento del almacén de metadatos.

Sintaxis

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

Miembros

  • wszFieldName
    Nombre del campo. La longitud máxima es de 128 caracteres más el terminador nulo.

  • ulFieldType
    Tipo de datos del campo.

  • ulFieldSize
    Longitud máxima para los campos de longitud variable, como una cadena o una matriz de bytes. Este valor se omite en los tipos de longitud fija.

Notas

Se puede definir un conjunto de campos personalizados para los metadatos del elemento. Cada campo está compuesto por un nombre de cadena único y un valor. Si existen metadatos adicionales relacionados con un elemento que no son admitidos por el conjunto predeterminado de metadatos del elemento, pueden almacenarse en estos campos. Se puede tener acceso a los campos a través de varios métodos de IItemMetadata, como IItemMetadata::TryGetFieldByteArray o IItemMetadata::SetFieldByteArray. Estos campos y su formato, incluso el tamaño y el tipo de datos, se definen cuando el almacén de metadatos se inicializa para una réplica usando ISyncMetadataStore::InitializeReplicaMetadata.

El esquema contiene la longitud del valor del campo. Para los campos de longitud fija, este valor es el tamaño del tipo de datos en bytes. Para los campos de longitud variable, este valor especifica la longitud máxima del campo, en bytes cuando para una matriz de bytes o en caracteres para una cadena.

Consideraciones especiales al usar la implementación proporcionada por Metadata Storage Service

Los nombres de campo deben obedecer las restricciones siguientes.

  • Los nombres de campo deben ser únicos dentro del conjunto de definiciones de campo

  • El primer carácter del nombre debe ser una letra (tal como se define en el estándar Unicode, por ejemplo, A-Z o a-z) o un subrayado (_).

  • Los siguientes caracteres del nombre pueden ser letras, números decimales o uno de estos símbolos: _@#$.

  • Los nombres no pueden contener espacios incrustados, tabulaciones ni cualquier otro carácter especial.

  • Los nombres no pueden coincidir con ninguna palabra reservada de Transact-SQL.

El almacén de metadatos también impone ciertos límites de tamaño que afectan a los valores de campo. El tamaño total para cada entrada de metadatos de elemento está limitado a 8060 bytes. El archivo de almacén de metadatos está limitado a 4 GB.

Requisitos

Encabezado: Metastore.h

Vea también

Otros recursos

Componentes de Sync Framework Metadata Storage Service