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

아티클
08/25/2023

연결된 개체의 링크 원본 표시 이름을 검색합니다.

구문

HRESULT GetSourceDisplayName(
  [out] LPOLESTR *ppszDisplayName
);

매개 변수

[out] ppszDisplayName

링크 원본의 표시 이름에 대한 포인터를 수신하는 포인터 변수의 주소입니다. 오류가 발생하면 ppszDisplayName 이 NULL로 설정됩니다. 그렇지 않으면 구현은 IMalloc::Alloc 를 사용하여 ppszDisplayName에서 반환된 문자열을 할당해야 하며 호출자는 IMalloc::Free 를 호출하여 해제해야 합니다. 호출자와 호출자 모두 CoGetMalloc에서 반환된 할당자를 사용합니다.

반환 값

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

반환 코드	설명
E_FAIL	작업이 실패했습니다.

표시 이름을 검색하려면 이러한 함수를 호출해야 합니다. 따라서 이 메서드는 CreateBindCtx 및 IMoniker::GetDisplayName에서 생성된 오류를 반환할 수 있습니다.

설명

발신자에 대한 참고 사항

컨테이너 애플리케이션 은 IOleLink::GetSourceDisplayName 을 호출하여 링크의 현재 원본을 표시할 수 있습니다.

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

구현자에 대한 참고 사항

연결된 개체의 IOleLink::GetSourceDisplayName 구현은 IOleLink::GetSourceMoniker 를 호출하여 링크 원본 모니커를 가져옵니다. 그런 다음 IMoniker::GetDisplayName 을 호출하여 해당 모니커의 표시 이름을 가져옵니다. 이 작업은 모니커를 바인딩해야 할 수 있으므로 비용이 많이 들 수 있습니다. 시스템에서 제공하는 모든 모니커는 바인딩 없이 표시 이름을 반환할 수 있지만 다른 모니커 구현이 가능할 수 있다는 보장은 없습니다. IOleLink::GetSourceDisplayName을 반복적으로 호출하는 대신 컨테이너 애플리케이션은 링크 원본이 바인딩된 때마다 이름을 캐시하고 업데이트할 수 있습니다.

요구 사항

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