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 |