Compartilhar via

Método IBindCtx::GetObjectParam (objidl.h)

  • Artigo

Recupera um ponteiro de interface para o objeto associado à chave especificada na tabela de ponteiros com chave de cadeia de caracteres do contexto de associação.

Sintaxe

HRESULT GetObjectParam(
  [in]  LPOLESTR pszKey,
  [out] IUnknown **ppunk
);

Parâmetros

[in] pszKey

A chave de cadeia de caracteres de contexto de associação a ser pesquisada. A comparação de cadeia de caracteres de chave diferencia maiúsculas de minúsculas.

[out] ppunk

O endereço de uma variável de ponteiro IUnknown* que recebe o ponteiro de interface para o objeto associado a pszKey. Quando bem-sucedida, a implementação chama AddRef em *ppunk. É responsabilidade do chamador chamar Release. Se ocorrer um erro, a implementação definirá *ppunk como NULL.

Retornar valor

Se o método for bem-sucedido, o valor retornado será S_OK. Caso contrário, será E_FAIL.

Comentários

Um contexto de associação mantém uma tabela de ponteiros de interface, cada um associado a uma chave de cadeia de caracteres. Isso permite a comunicação entre uma implementação de moniker e o chamador que iniciou a operação de associação. Uma parte pode armazenar um ponteiro de interface sob uma cadeia de caracteres conhecida por ambas as partes para que a outra parte possa recuperá-lo posteriormente do contexto de associação.

O ponteiro que esse método recupera deve ter sido inserido anteriormente na tabela usando o método IBindCtx::RegisterObjectParam .

Anotações aos Chamadores

Objetos que usam monikers para localizar outros objetos podem chamar esse método quando uma operação de associação falha ao obter informações específicas sobre o erro ocorrido. Dependendo do erro, pode ser possível corrigir a situação e repetir a operação de associação. Consulte IBindCtx::RegisterObjectParam para obter mais informações.

As implementações do Moniker podem chamar esse método para lidar com situações em que um chamador inicia uma operação de associação e solicita informações específicas. Por convenção, o implementador deve usar nomes de chave que começam com a forma de cadeia de caracteres do CLSID de uma classe de moniker. (Consulte a função StringFromCLSID .)

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 objidl.h

Confira também

Ibindctx