IMsmMerge::Merge 메서드(mergemod.h)
Merge 메서드는 현재 데이터베이스와 현재 모듈의 통합을 실행합니다. 통합은 모듈의 구성 요소를 Feature로 식별된 기능에 연결합니다. 모듈 디렉터리 트리의 루트는 RedirectDir에서 지정한 위치로 리디렉션됩니다. 자세한 내용은 Merge 개체의 Merge 메서드를 참조하세요.
IMsmMerge2::Merge Mergemod.dll 버전 2.0 이상.
구문
HRESULT Merge(
[in] const BSTR Feature,
[in] const BSTR RedirectDir
);
매개 변수
[in] Feature
데이터베이스에 있는 기능의 이름입니다. BSTR 대신 LPCWSTR을 사용할 수 있습니다.
[in] RedirectDir
데이터베이스의 Directory 테이블에 있는 항목의 키입니다. BSTR 대신 LPCWSTR을 사용할 수 있습니다. 이 매개 변수는 null 또는 빈 문자열일 수 있습니다.
반환 값
Merge 함수는 다음 값을 반환합니다.
| 값 | 의미 |
|---|---|
|
병합이 치명적으로 실패했습니다. 이는 작동 오류를 나타내며 실패한 병합에 대한 일반적인 오류 반환이 아닙니다. |
|
함수가 성공했지만 오류가 있었고 병합 자체가 유효하지 않을 수 있습니다. |
|
인수 중 하나가 잘못되었습니다. |
|
시스템에서 메모리가 부족하여 작업을 완료할 수 없습니다. |
|
함수가 성공했습니다. |
설명
이 함수는 현재 데이터베이스와 현재 모듈의 병합을 실행합니다. 모듈 디렉터리 트리의 루트는 RedirectDir에서 지정한 위치로 리디렉션됩니다. 제외를 포함하여 통합 충돌이 발생하면 나중에 검색할 수 있도록 오류 열거자에 배치되지만 통합이 실패하지는 않습니다. get_Errors 함수를 사용하여 오류를 검색할 수 있습니다. 오류 및 정보 메시지는 현재 로그 파일에 게시됩니다.
Merge 함수는 모듈의 모든 기능 참조를 가져오고 모듈 데이터베이스에서 null GUID가 발생하는 모든 항목에 대한 기능 참조를 대체합니다. 자세한 내용은 통합 모듈의 기능 참조를 참조하세요.
통합이 완료되면 모듈의 구성 요소가 Feature로 식별된 기능에 연결됩니다. 이 기능은 이미 존재해야 하며 생성되지 않았습니다.
모듈은 Connect 함수를 사용하여 추가 기능에 연결할 수 있습니다. Connect 함수를 호출하면 기능 구성 요소 연결만 생성됩니다. 데이터베이스에 이미 통합된 행은 수정되지 않습니다.
closeDatabase 함수가 bCommit이 TRUE로 설정된 상태에서 호출되지 않는 한 데이터베이스에 대한 변경 내용은 디스크에 저장되지 않습니다.
요구 사항
| 지원되는 최소 클라이언트 | Mergemod.dll 1.0 이상 |
| 대상 플랫폼 | Windows |
| 헤더 | mergemod.h |
| DLL | Mergemod.dll |