Estrutura CUSTOM_FIELD_DEFINITION
Contém as informações de esquema que definem um campo personalizado de um item no repositório de metadados.
typedef struct _CUSTOM_FIELD_DEFINITION
{
WCHAR wszFieldName[129];
SYNC_METADATA_FIELD_TYPE ulFieldType;
ULONG ulFieldSize;
} CUSTOM_FIELD_DEFINITION;
Membros
- wszFieldName
O nome do campo. O comprimento máximo é de 128 caracteres, mais o terminador nulo.
- ulFieldType
O tipo de dados do campo.
- ulFieldSize
O comprimento máximo de campos com comprimento variável, como uma cadeia de caracteres ou uma matriz de bytes. Esse valor é ignorado para tipos de comprimento fixo.
Comentários
Um conjunto de campos personalizados pode ser definido para metadados do item. Cada campo consiste em um nome de cadeia de caracteres exclusivo e um valor. Esses campos podem ser usados para armazenar quaisquer metadados adicionais sobre um item que não é aceito de outra forma pelo conjunto padrão de metadados do item. Os campos podem ser acessados através de vários métodos no IItemMetadata, como IItemMetadata::TryGetFieldByteArray ou IItemMetadata::SetFieldByteArray. Estes campos e seus formatos, incluindo o tamanho e o tipo de dados, são definidos quando o repositório de metadados é inicializado para uma réplica usando ISyncMetadataStore::InitializeReplicaMetadata.
O esquema contém o comprimento do valor do campo. No caso de campos com comprimento fixo, este valor é o tamanho do tipo de dados em bytes. Para campos de comprimento variável, esse valor especifica o comprimento máximo, em bytes para uma matriz de bytes ou em caracteres para uma cadeia de caracteres.
Considerações especiais ao usar a implementação oferecida pelo Serviço de Armazenamento de Metadados
Os nomes de campo precisam obedecer às restrições a seguir.
Os nomes de campo precisam ser exclusivos no conjunto de definição de dados.
O primeiro caractere do nome precisa ser uma letra (conforme definido pelo padrão Unicode, por exemplo, A-Z ou a-z) ou um caractere de sublinhado (_).
Caracteres subsequentes no nome podem ser letras, números decimais ou um destes símbolos: _@#$.
Os nomes não podem conter espaços, tabulações ou quaisquer outros caracteres especiais incorporados.
Os nomes não podem ser iguais às palavras reservadas do Transact-SQL.
O repositório de metadados também impõe determinados limites de tamanho e influenciam os valores de campo. O tamanho total para cada entrada de metadados de item é limitado a 8060 bytes. O arquivo de repositório de metadados fica limitado a 4GB.
Requisitos
Cabeçalho: Metastore.h