Merge.MergeEx 메서드

Merge 개체의 MergeEx 메서드는 추가 인수를 사용한다는 점을 제외하고 Merge 함수와 동일합니다. pConfiguration 인수는 클라이언트에서 구현하는 인터페이스입니다. 이 인수는 null일 수 있습니다. 이 인수의 존재는 클라이언트가 구성 기능을 지원할 수 있지만 클라이언트가 구성 가능한 특정 항목에 대한 구성 데이터를 제공할 의무가 없음을 나타냅니다.

Merge 메서드는 현재 데이터베이스와 현재 모듈의 통합을 실행합니다. 통합은 모듈의 구성 요소를 Feature로 식별된 기능에 연결합니다. 모듈 디렉터리 트리의 루트는 RedirectDir에서 지정한 위치로 리디렉션됩니다.

구문

Merge.MergeEx(
  Feature,
  RedirectDir,
  pConfiguration
)

매개 변수

기능

데이터베이스에 있는 기능의 이름입니다.

RedirectDir

데이터베이스의 Directory 테이블에 있는 항목의 키입니다. 이 매개 변수는 null이거나 빈 문자열일 있습니다.

pConfiguration

pConfiguration 인수는 클라이언트에서 구현하는 인터페이스입니다. 이 인수는 null일 수 있습니다. 이 인수의 존재는 클라이언트가 구성 기능을 지원할 수 있지만 클라이언트가 구성 가능한 특정 항목에 대한 구성 데이터를 제공할 의무가 없음을 나타냅니다.

반환 값

이 메서드는 값을 반환하지 않습니다.

설명

통합이 완료되면 모듈의 구성 요소가 Feature로 식별된 기능에 연결됩니다. 이 기능은 만들어지지 않으며 기존 기능이어야 합니다. 모듈은 Connect 메서드를 사용하여 추가 기능에 연결할 수 있습니다.

데이터베이스에 대한 변경 내용은 CloseDatabase 메서드가 bCommitTRUE로 설정된 상태에서 호출되는 경우에만 저장됩니다.

제외를 포함하여 통합 충돌이 발생하면 나중에 검색할 수 있도록 오류 열거자에 배치되지만 통합이 실패하지는 않습니다. Errors 속성을 통해 오류를 검색할 수 있습니다. 오류 및 정보 메시지는 현재 로그 파일에 게시됩니다.

잘못된 모듈 구성으로 인해 통합이 실패하면 MergeEx 함수는 E_FAIL을 반환합니다. 여기에는 msmErrorType 오류(msmErrorBadNullSubstitution, msmErrorBadSubstitutionType, msmErrorBadNullResponse, msmErrorMissingConfigItemmsmErrorDataRequestFailed)가 포함됩니다. 이러한 오류로 인해 오류가 발생하면 통합이 즉시 중지됩니다. MergeEx가 E_FAIL을 반환할 때 오류 개체가 여전히 열거자에 추가됩니다. msmErrorType 오류에 대한 자세한 내용은 get_Type 함수(오류 개체)를 참조하세요. 다른 모든 오류로 인해 MergeEx가 S_FALSE를 반환하고 통합이 계속되도록 합니다.

C++

MergeEx 함수를 참조하세요.

요구 사항

요구 사항
버전
Mergemod.dll 2.0 이상
헤더
Mergemod.h
DLL
Mergemod.dll