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

  • Artigo

Recupera um ponteiro para uma interface que pode ser usada para enumerar as chaves da tabela de ponteiros com chave de cadeia de caracteres do contexto de associação.

Sintaxe

HRESULT EnumObjectParam(
  [out] IEnumString **ppenum
);

Parâmetros

[out] ppenum

O endereço de uma variável de ponteiro IEnumString* que recebe o ponteiro de interface para o enumerador. Se ocorrer um erro, *ppenum será definido como NULL. Se *ppenum não for NULL, a implementação chamará AddRef em *ppenum; é responsabilidade do chamador chamar Release.

Retornar valor

Esse método pode retornar os valores retornados padrão E_OUTOFMEMORY e S_OK.

Comentários

As chaves retornadas pelo enumerador são as especificadas anteriormente em chamadas para IBindCtx::RegisterObjectParam.

Anotações aos Chamadores

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.

Na implementação do sistema da interface IBindCtx , esse método não é implementado. Portanto, chamar esse método resulta em um valor retornado de E_NOTIMPL.

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

Ienumstring