IBindCtx::GetObjectParam

9/8/2008

Este método recupera o ponteiro associado com a chave especificada no seqüência de caracteres do contexto de BIND-de chave tabela de ponteiros.

O IBindCtx::GetObjectParam método é com suporte DCOM, mas ele não é com suporte em COM.

Chamar esse método em COM retorna um valor de E_NOTIMPL.

Syntax

HRESULT GetObjectParam(
  LPOLESTR pszKey,
  IUnknown** ppunk
);

Parameters

• pszKey
  [in] Pointer to a zero-terminated wide character string (two bytes per character) containing the key to search for. Chave comparação de seqüência de caracteres é com diferenciação de maiúsculas e minúsculas.

• ppunk
  [out] Endereço das IUnknown * ponteiro variável que recebe o ponteiro interface para o objeto associado com pszKey.

  Quando bem-sucedido, chamadas de implementação de IUnknown::AddRef método Logon *ppunk.

  É responsabilidade do chamador para chamar o IUnknown::Release método.

  Se ocorrer um erro, a implementação definirá *ppunk para NULL.

Return Value

A seguinte tabela mostra os valores de retorno para este método.

Valor	Descrição
E_FAIL	Um padrão valor de retorno.
S_OK	O ponteiro associado com a chave especificada foi retornado com êxito.

Remarks

Um contexto BIND mantém uma tabela de interface ponteiros, cada associado com uma chave seqüência de caracteres. Isso permite a comunicação entre uma implementação moniker e o chamador que iniciou a operação ligação.

Uma parte pode armazenar um ponteiro interface em um seqüência de caracteres conhecidos por ambas as partes so that a outra parte pode posteriormente recuperar de contexto de BIND.

O ponteiro Este método recupera deve anteriormente foram inserido em tabela usando o IBindCtx::RegisterObjectParam método.

Para determinar se a plataforma oferece suporte a esta interface, consulte Determinando suporte COM APIs.

Notas para chamadores

Aqueles gravar uma nova classe moniker (através de uma implementação IMoniker) e por alguns clientes moniker (objetos usando uma moniker para BIND para um objeto) podem chamar IBindCtx::GetObjectParam.

Objetos com identificadores de origem para localizar outros objetos podem chamar esse método quando uma operação ligação falha ao get informações específicas sobre o erro que ocorreu.

Dependendo do erro, talvez seja possível corrigir a situação e repetir a operação ligação. Consulte IBindCtx::RegisterObjectParam Para obter mais informações.

Moniker implementações podem chamar este método para lidar com situações em que um chamador inicia uma operação ligação e solicita informações específicas.

Por convenção, o implementador deve usar chave nomes que começam com a forma seqüência de caracteres da CLSID de uma classe moniker. Veja a seção StringFromCLSID função.

Requirements

Header	objidl.h, objidl.idl
Library	ole32.lib, uuid.lib
Windows Embedded CE	Windows CE 2.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

StringFromCLSID
IMoniker
IBindCtx::RegisterObjectParam
IBindCtx::EnumObjectParam
IUnknown::AddRef
IUnknown::Release