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에서 제공하는 구현을 사용할 때의 특별 고려 사항
필드 이름에는 다음과 같은 제한 사항이 있습니다.
필드 이름은 필드 정의 집합 내에서 고유해야 합니다.
이름의 첫 자는 유니코드 표준에 정의된 문자(예: A-Z 또는 a-z) 또는 밑줄(_)이어야 합니다.
이름의 두 번째 문자부터는 영문자, 숫자 또는 _@#$ 기호 중 하나를 사용할 수 있습니다.
이름에는 공백, 탭 또는 기타 특수 문자를 사용할 수 없습니다.
Transact-SQL 예약어는 이름으로 사용할 수 없습니다.
메타데이터 저장소에는 필드 값에 영향을 미치는 일부 크기 제한도 있습니다. 각 메타데이터 항목의 총 크기는 8060바이트로 제한됩니다. 메타데이터 저장소 파일의 최대 크기는 4GB입니다.
요구 사항
헤더: Metastore.h