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

아티클
08/25/2023

링크 원본의 표시 이름을 설정합니다.

구문

HRESULT SetSourceDisplayName(
  [in] LPCOLESTR pszStatusText
);

매개 변수

[in] pszStatusText

새 링크 원본의 표시 이름에 대한 포인터입니다. 이 매개 변수는 NULL일 수 없습니다.

반환 값

이 메서드는 성공에 대한 S_OK 반환합니다.

MkParseDisplayName의 값도 여기에 반환될 수 있습니다.

설명

발신자에게 참고 사항

컨테이너 애플리케이션은 최종 사용자가 링크의 원본을 변경하거나 링크를 끊을 때 IOleLink::SetSourceDisplayName 을 호출할 수 있습니다. 이렇게 하려면 연결된 개체가 표시 이름에서 모니커를 만들어야 합니다. 표시 이름을 모니커로 구문 분석하려는 경우 컨테이너는 IOleLink::SetSourceDisplayName 대신 IOleLink::SetSourceMoniker를 호출할 수 있습니다.

OleUIEditLinks 함수를 사용하여 링크 대화 상자를 표시하는 경우 IOleUILinkContainer 인터페이스를 구현해야 합니다. 대화 상자는 IOleUILinkContainer::SetLinkSource 및 IOleUILinkContainer::CancelLink의 구현을 호출합니다. 이러한 메서드의 구현은 IOleLink::SetSourceDisplayName을 호출할 수 있습니다.

컨테이너 애플리케이션이 새로 지정된 링크 원본에 즉시 바인딩되는 경우 MkParseDisplayName 및 IOleLink::SetSourceMoniker 를 대신 호출한 다음 구문 분석 작업의 바인딩 컨텍스트를 사용하여 IOleLink::BindToSource 를 호출해야 합니다. 바인딩 컨텍스트를 다시 사용하면 발생할 수 있는 개체의 중복 로드를 방지할 수 있습니다.

구현자에 대한 참고 사항

IOleLink::SetSourceDisplayName에 대한 계약은 연결된 개체가 표시 이름을 모니커로 구문 분석할 시기를 지정하지 않습니다. 구문 분석이 IOleLink::SetSourceDisplayName 이 반환되기 전에 발생할 수 있습니다. 또는 연결된 개체가 표시 이름을 저장하고 링크 원본에 바인딩해야 하는 경우에만 구문 분석할 수 있습니다. 표시 이름을 구문 분석하는 작업은 링크 원본에 바인딩해야 할 수 있으므로 비용이 많이 들 수 있습니다. 제공된 IOleLink::SetSourceDisplayName 구현은 표시 이름을 구문 분석한 다음 구문 분석 작업에 사용되는 바인딩 컨텍스트를 해제합니다. 이로 인해 링크 원본 서버가 실행되고 중지됩니다.

연결된 개체가 현재 링크 원본에 바인딩된 경우 IOleLink::SetSourceDisplayName 을 구현하면 연결이 끊어집니다.

연결된 개체가 모니커를 저장하고 링크 원본에 사용하는 방법에 대한 자세한 내용은 IOleLink::SetSourceMoniker를 참조하세요.

요구 사항

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