MonikerRelativePathTo 함수(objbase.h)

  • 아티클

첫 번째 지정된 모니커(또는 구조가 비슷한 모니커)의 끝에 구성될 때 두 번째 지정된 모니커를 생성하는 모니커를 제공합니다.

이 함수는 IMoniker::RelativePathTo 구현에서만 사용하기 위한 것입니다.

구문

HRESULT MonikerRelativePathTo(
  [in]  LPMONIKER pmkSrc,
  [in]  LPMONIKER pmkDest,
  [out] LPMONIKER *ppmkRelPath,
  [in]  BOOL      dwReserved
);

매개 변수

[in] pmkSrc

만들 상대 모니커로 구성된 경우 pmkDest를 생성하는 모니커의 IMoniker 인터페이스에 대한 포인터입니다. 이 모니커는 만들 상대 모니커의 "원본"을 식별합니다.

[in] pmkDest

pmkSrc를 기준으로 표현할 모니커의 IMoniker 인터페이스에 대한 포인터입니다. 이 모니커는 만들 상대 모니커의 대상을 식별합니다.

[out] ppmkRelPath

새 상대 모니커에 대한 인터페이스 포인터를 수신하는 IMoniker* 포인터 변수의 주소입니다. 성공하면 함수가 모니커에서 AddRef 를 호출하고 호출자는 Release를 호출합니다. 오류가 발생하면 인터페이스 포인터 값은 NULL입니다.

[in] dwReserved

이 매개 변수는 예약되어 있으며 0이 아니어야 합니다.

반환 값

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

반환 코드 Description
S_OK
 의미 있는 상대 경로가 반환되었습니다.
MK_S_HIM
 상대 경로의 유일한 형태는 다른 모니커입니다.
MK_E_NOTBINDABLE
 pmkSrc 매개 변수는 항목 모니커와 같은 상대 모니커이며 상대 경로를 확인하려면 먼저 컨테이너의 모니커로 구성해야 합니다.

설명

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

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

요구 사항

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

추가 정보

IMoniker::RelativePathTo