다음을 통해 공유


ConfigureModule.ProvideTextData 메서드

ProvideTextData 메서드는 클라이언트 도구에서 텍스트 데이터를 검색하기 위해 Mergemod.dll이 호출합니다. Mergemod.dll은 ModuleConfiguration 테이블의 해당 항목에서 이름을 제공합니다.

도구는 S_OK를 반환하고 ConfigData에 적절한 사용자 지정 텍스트를 제공해야 합니다. 클라이언트 도구는 데이터를 할당하지만 Mergemod.dll은 메모리 해제를 담당합니다. 이 인수는 BSTR 개체여야 합니다. LPCWSTR은 허용되지 않습니다.

도구에서 이 이름 값에 대한 구성 데이터를 제공하지 않으면 함수는 S_FALSE를 반환해야 합니다. 이 경우 Mergemod.dll은 ConfigData 인수의 값을 무시하고 ModuleConfiguration 테이블의 기본값을 사용합니다.

S_OK 또는 S_FALSE 이외의 반환 코드로 인해 로그에 기록되는(로그가 열려 있는 경우) 오류가 발생하고 통합이 실패합니다.

이 함수는 표준 BSTR 규칙을 따르므로 null은 빈 문자열과 동일합니다.

구문

ConfigureModule.ProvideTextData(
  Name,
  ConfigData
)

매개 변수

이름

데이터를 검색할 항목의 이름입니다.

ConfigData

사용자 지정 텍스트에 대한 포인터입니다.

반환 값

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

설명

ModuleConfiguration 테이블의 각 레코드에 대해 클라이언트를 두 번 이상 호출할 수 있습니다. Mergemod.dll은 동일한 "이름" 값에 대해 클라이언트를 여러 차례 호출하지 않습니다. ModuleSubstitution 테이블에서 속성을 사용하는 레코드가 없으면 ModuleConfiguration 테이블의 항목으로 인한 클라이언트 호출이 발생하지 않습니다.

C++

ProvideTextData 함수를 참조하세요.

요구 사항

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