다음을 통해 공유

IOleObject::SetHostNames 메서드(oleidl.h)

  • 아티클

개체에 컨테이너 애플리케이션의 이름과 포함된 복합 문서를 제공합니다.

구문

HRESULT SetHostNames(
  [in] LPCOLESTR szContainerApp,
  [in] LPCOLESTR szContainerObj
);

매개 변수

[in] szContainerApp

개체가 실행되고 있는 컨테이너 응용 프로그램의 이름에 대한 포인터입니다.

[in] szContainerObj

개체가 포함된 복합 문서의 이름에 대한 포인터입니다. 복합 문서의 이름을 표시하지 않으려면 이 매개 변수를 NULL로 설정할 수 있습니다.

반환 값

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

설명

발신자에 대한 참고 사항

연결된 개체의 경우 링크 원본이 별도의 편집 창과 제목 표시줄 정보를 제공하므로 포함된 개체에 대해서만 IOleObject::SetHostNames 를 호출합니다.

구현자에 대한 참고 사항

개체의 IOleObject::SetHostNames 애플리케이션에는 개체의 포함된 상태에 적합할 수 있는 사용자 인터페이스 수정 내용이 포함되어야 합니다. 이러한 수정에는 일반적으로 메뉴 명령 추가 및 제거 및 편집 창의 제목 표시줄에 표시되는 텍스트 변경이 포함됩니다.

SDI 컨테이너 애플리케이션 또는 최대화된 자식 창이 있는 MDI 애플리케이션의 포함된 개체에 대한 전체 창 제목은 다음과 같이 표시됩니다.

<object application name> - <object short type> in <container document>

그렇지 않으면 제목은 다음이어야 합니다.

<object application name> - <container document>

"개체 줄임표 형식"은 목록 상자에 전체로 표시될 수 있을 만큼 짧은 개체 이름의 형식을 나타냅니다. 이러한 식별 문자열은 개체의 영구 상태의 일부로 저장되지 않으므로 개체가 로드되거나 실행될 때마다 IOleObject::SetHostNames 를 호출해야 합니다.

요구 사항

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

추가 정보

IOleObject

IOleObject::GetUserType