Compartilhar via


Método IOleObject::SetHostNames (oleidl.h)

Fornece um objeto com os nomes de seu aplicativo de contêiner e o documento composto no qual ele está inserido.

Sintaxe

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

Parâmetros

[in] szContainerApp

Ponteiro para o nome do aplicativo de contêiner no qual o objeto está em execução.

[in] szContainerObj

Ponteiro para o nome do documento composto que contém o objeto . Se você não quiser exibir o nome do documento composto, poderá definir esse parâmetro como NULL.

Retornar valor

Esse método retorna S_OK em caso de êxito.

Comentários

Anotações para chamadores

Chame IOleObject::SetHostNames somente para objetos inseridos, pois para objetos vinculados, a fonte do link fornece suas próprias informações separadas da janela de edição e da barra de título.

Observações aos implementadores

A aplicação de um objeto de IOleObject::SetHostNames deve incluir quaisquer modificações em sua interface do usuário que possam ser apropriadas para o estado inserido de um objeto. Essas modificações normalmente incluirão adicionar e remover comandos de menu e alterar o texto exibido na barra de título da janela de edição.

O título completo da janela para um objeto inserido em um aplicativo de contêiner SDI ou um aplicativo MDI com uma janela filho maximizada deve aparecer da seguinte maneira:

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

Caso contrário, o título deverá ser:

<object application name> - <container document>

O "tipo curto de objeto" refere-se a uma forma de nome de objeto curto o suficiente para ser exibido na íntegra em uma caixa de listagem. Como essas cadeias de caracteres de identificação não são armazenadas como parte do estado persistente do objeto, IOleObject::SetHostNames deve ser chamado sempre que o objeto é carregado ou executado.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho oleidl.h

Confira também

Ioleobject

IOleObject::GetUserType