IOleLink::GetSourceMoniker 메서드(oleidl.h)

아티클
08/25/2023

연결된 개체의 링크 원본을 식별하는 모니커를 검색합니다.

구문

HRESULT GetSourceMoniker(
  [out] IMoniker **ppmk
);

매개 변수

[out] ppmk

링크 원본을 식별하는 절대 모니커에 대한 인터페이스 포인터를 수신하는 IMoniker 포인터 변수의 주소입니다. 성공하면 구현은 ppmk에서 AddRef를 호출해야 합니다. 릴리스를 호출하는 것은 호출자의 책임입니다. 오류가 발생하면 구현에서 ppmk 를 NULL로 설정해야 합니다.

반환 값

이 메서드는 성공에 대한 S_OK 반환합니다. 다른 가능한 반환 값은 다음과 같습니다.

반환 코드	설명
MK_E_UNAVAILABLE	모니커를 사용할 수 없습니다.

설명

발신자에게 참고 사항

컨테이너 애플리케이션 은 IOleLink::GetSourceMoniker 를 호출하여 링크 대화 상자에 링크의 현재 원본을 표시할 수 있습니다. 이렇게 하려면 컨테이너가 IMoniker::GetDisplayName 메서드를 사용하여 모니커의 표시 이름을 가져와야 합니다. 표시 이름을 직접 가져오는 경우 컨테이너 는 IOleLink::GetSourceMoniker 대신 IOleLink::GetSourceDisplayName 을 호출 할 수 있습니다.

OleUIEditLinks 함수를 사용하여 링크 대화 상자를 표시하는 경우 IOleUILinkContainer 인터페이스를 구현해야 합니다. 대화 상자는 IOleUILinkContainer::GetLinkSource 의 구현을 호출하여 표시해야 하는 문자열을 가져옵니다. 해당 메서드의 구현은 IOleLink::GetSourceMoniker를 호출할 수 있습니다.

구현자에 대한 참고 사항

연결된 개체는 링크 원본에 대한 절대 모니커와 상대 모니커를 모두 저장합니다. 상대 모니커가 NULL 이 아니고 복합 문서에 모니커를 사용할 수 있는 경우 IOleLink::GetSourceMoniker 는 복합 문서의 모니커 끝에 상대 모니커를 작성하여 만든 모니커를 반환합니다. 그렇지 않으면 절대 모니커를 반환하거나 오류가 발생하면 NULL을 반환합니다.

컨테이너는 OleCreateLink 함수 중 하나를 호출하여 링크를 만들 때 절대 모니커를 지정합니다. 애플리케이션은 IOleLink::GetSourceMoniker 또는 IOleLink::GetSourceDisplayName 을 호출하여 절대 모니커를 변경할 수 있습니다. 또한 연결된 개체는 링크 원본에 성공적으로 바인딩되거나 링크 원본에 바인딩되고 IAdviseSink::OnRename 메서드를 통해 이름 바꾸기 알림을 받을 때마다 모니커를 자동으로 업데이트합니다.

요구 사항


지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	oleidl.h