Share via

Função CoGetObject (objbase.h)

  • Artigo

Converte um nome de exibição em um moniker que identifica o objeto chamado e, em seguida, associa-se ao objeto identificado pelo moniker.

Sintaxe

HRESULT CoGetObject(
  [in]           LPCWSTR   pszName,
  [in, optional] BIND_OPTS *pBindOptions,
  [in]           REFIID    riid,
  [out]          void      **ppv
);

Parâmetros

[in] pszName

O nome de exibição do objeto a ser criado.

[in, optional] pBindOptions

As opções de associação usadas para criar um moniker que cria o objeto real. Para obter detalhes, consulte BIND_OPTS. Este parâmetro pode ser NULL.

[in] riid

Uma referência ao identificador de uma interface que é implementada no objeto a ser criado.

[out] ppv

O endereço de um ponteiro para a interface especificada por riid no objeto que é criado.

Retornar valor

Essa função pode retornar os valores de retorno padrão E_FAIL, E_OUTOFMEMORY e E_UNEXPECTED, bem como os valores a seguir.

Código de retorno Descrição
S_OK
 O objeto foi criado com êxito.
MK_E_SYNTAX
 O parâmetro pszName não é um nome de exibição formado corretamente.
MK_E_NOOBJECT
 Não foi possível encontrar o objeto identificado por esse moniker ou algum objeto identificado pelo moniker composto do qual esse moniker faz parte.
MK_E_EXCEEDEDDEADLINE
 A operação de associação não pôde ser concluída dentro do limite de tempo especificado pela estrutura BIND_OPTS passada em pBindOptions.
MK_E_CONNECTMANUALLY
 A operação de associação requer assistência do usuário final. Os motivos mais comuns para retornar esse valor são que uma senha é necessária ou que um disquete precisa ser montado.
MK_E_INTERMEDIATEINTERFACENOTSUPPORTED
 Um objeto intermediário foi encontrado, mas não deu suporte a uma interface necessária para concluir a operação de associação. Por exemplo, um moniker de item retornará esse valor se seu contêiner não oferecer suporte à interface IOleItemContainer .

Comentários

O CoGetObject encapsula chamadas para as funções de biblioteca COM CreateBindCtx, MkParseDisplayName e IMoniker::BindToObject.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows 2000 Server [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho objbase.h
Biblioteca Ole32.lib
DLL Ole32.dll

Confira também

BIND_OPTS