CoGetObject

9/8/2008

Essa função converte um nome exibir em uma moniker que identifica o objeto nomeado e, em seguida, vincula para o objeto identificado pelo moniker.

Syntax

WINOLEAPI CoGetObject(
  LPCWSTR pszName,
  BIND_OPTS* pBindOptions,
  REFIID riid,
  void** ppv
);

Parameters

• pszName
  [no] Exibir o nome, na formato da seqüência de caracteres, do objeto a ser criado.

• pBindOptions
  [no] Ligação opções usadas para criar um moniker que cria o real objeto.

• riid
  [no] Referência a identificação de uma interface que é implementado no objeto a ser criado.

• PPV
  [out] Endereço de um ponteiro para a interface especificada por riid Sobre o objeto que é criado.

Return Value

O padrão oferece suporte a essa função retornar valores E_FAIL, E_OUTOFMEMORY e E_UNEXPECTED, bem como o seguinte:

• S_OK
  O objeto foi criado com êxito.

• MK_E_SYNTAX
  O pszName parâmetro não é um nome exibir formado corretamente.

• MK_E_NOOBJECT
  O objeto identificado por este moniker, ou algum objeto identificado pela composição do qual este moniker é uma parte, moniker não pôde ser encontrado.

• MK_E_EXCEEDEDDEADLINE
  A operação ligação não pôde ser concluída no limite de tempo especificado pelo BIND_OPTS estrutura passado pBindOptions.

• MK_E_CONNECTMANUALLY
  A operação ligação requer assistência a partir de usuário final. The most comum razões para retornar esse valor são que uma senha é necessária ou que um disquete precisa ser montado.

• MK_E_INTERMEDIATEINTERFACENOTSUPPORTED
  Um intermediário objeto foi encontrado, mas ele não suporte uma interface exigido para a operação ligação completo. De exemplo, um moniker item retornará esse valor se seu contêiner não suporte a IOleItemContainer interface.

Remarks

CoGetObject Encapsula chamadas a funções de biblioteca COM CreateBindCtx, MkParseDisplayName, e IMoniker::BindToObject.

Para determinar se a plataforma oferece suporte a essa função, consulte Determinando suporte COM APIs.

Requirements

Header	objbase.h
Library	ole32.lib
Windows Embedded CE	Windows CE 3.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

COM Functions
IMoniker