항목의 전역 ID를 가져옵니다.
HRESULT GetGlobalId(
BYTE * pbGlobalId,
ULONG * pcbGlobalId);
매개 변수
- pbGlobalId
[in, out, size_is(*pcbGlobalId), unique] 항목의 전역 ID를 반환합니다.
- pcbGlobalId
[in, out] pbGlobalId의 바이트 수를 지정합니다. pbGlobalId가 너무 작으면 전역 ID를 검색하는 데 필요한 바이트 수를 반환하고, 그렇지 않으면 쓴 바이트 수를 반환합니다.
반환 값
S_OK
전역 ID가 설정되어 있지 않으면 S_FALS입니다.
E_POINTER
pbGlobalId가 너무 작아서 필드 값을 받을 수 없으면 HRESULT_FROM_WIN32(ERROR_MORE_DATA)입니다. 이 경우 pcbGlobalId는 필요한 바이트 수를 반환합니다.
주의
전역 ID는 동기화 범위 전체에서 항목을 고유하게 식별합니다.
반환된 ID의 형식은 복제본을 초기화할 때 지정된 ID 형식 스키마에 따라 결정됩니다. ID 형식에 대한 자세한 내용은 표준 공급자에 대한 메타데이터 요구 사항을 참조하십시오.
IItemMetadata::SetGlobalId를 호출하여 전역 ID 값을 설정했지만 아직 IReplicaMetadata::SaveItemMetadata를 호출하여 변경 내용을 저장하지 않은 경우 GetGlobalId는 메타데이터 저장소에 저장된 값이 아니라 IItemMetadata 개체에 포함된 값을 반환합니다.