MonikerCommonPrefixWith 함수(objbase.h)

이 모니커(이 모니커 개체의 데이터로 구성된 모니커)가 다른 모니커와 공유하는 공통 접두사를 기반으로 새 모니커를 만듭니다.

이 함수는 IMoniker::CommonPrefixWith 구현에서만 호출됩니다.

구문

HRESULT MonikerCommonPrefixWith(
  [in]  LPMONIKER pmkThis,
  [in]  LPMONIKER pmkOther,
  [out] LPMONIKER *ppmkCommon
);

매개 변수

[in] pmkThis

공통 접두사를 찾는 모니커 중 하나의 IMoniker 인터페이스에 대한 포인터입니다. 일반적으로 이 호출을 사용하여 IMoniker::CommonPrefixWith를 구현하는 모니커입니다.

[in] pmkOther

첫 번째 모니커와 비교할 모니커의 IMoniker 인터페이스에 대한 포인터입니다.

[out] ppmkCommon

pmkThis 및 pmkOther의 공통 접두사를 기반으로 모니커에 대한 인터페이스 포인터를 수신하는 IMoniker* 포인터 변수의 주소입니다. 성공하면 함수가 모니커에서 AddRef 를 호출하고 호출자는 Release를 호출합니다. 오류가 발생하면 제공된 인터페이스 포인터 값은 NULL입니다.

반환 값

이 함수는 다음 값뿐만 아니라 E_OUTOFMEMORY 및 E_UNEXPECTED 표준 반환 값을 반환할 수 있습니다.

반환 코드	Description
S_OK	pmkThis도 pmkOther도 아닌 일반적인 접두사도 있습니다.
MK_S_HIM	전체 pmkOther 모니커는 pmkThis 모니커의 접두사입니다.
MK_S_ME	전체 pmkThis 모니커는 pmkOther 모니커의 접두사입니다.
MK_S_US	pmkThis 및 pmkOther 모니커가 동일합니다.
MK_E_NOPREFIX	모니커에는 일반적인 접두사가 없습니다.
MK_E_NOTBINDABLE	이 함수는 상대 모니커에서 호출되었습니다. 상대 모니커의 공통 접두사를 사용하는 것은 의미가 없습니다.

설명

IMoniker::CommonPrefixWith 구현은 먼저 다른 모니커가 특수한 방식으로 인식하고 처리하는 형식인지 여부를 검사 합니다. 그렇지 않은 경우 MonikerCommonPrefixWith를 호출하여 pmkThis 로 전달하고 다른 모니커를 pmkOther로 전달해야 합니다. MonikerCommonPrefixWith 는 두 모니커가 제네릭 복합인 경우를 올바르게 처리합니다.

pmkThis와 pmkOther가 모두 절대 모니커인 경우에만 이 함수를 호출해야 합니다(여기서 절대 모니커는 파일 모니커이거나 맨 왼쪽 구성 요소가 파일 모니커이고 파일 모니커가 절대 경로를 나타내는 제네릭 복합체임). 상대 모니커에서는 이 함수를 호출하지 마세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows 2000 Server [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	objbase.h
라이브러리	Ole32.lib
DLL	Ole32.dll

추가 정보

IMoniker::CommonPrefixWith