Método IOleControlSite::GetExtendedControl (ocidl.h)

  • Artigo

Recupera um ponteiro IDispatch para o controle estendido que o contêiner usa para encapsular o controle real.

Sintaxe

HRESULT GetExtendedControl(
  [out] IDispatch **ppDisp
);

Parâmetros

[out] ppDisp

Um ponteiro para uma variável de ponteiro IDispatch que recebe o ponteiro de interface para o controle estendido. Se ocorrer um erro, a implementação deverá definir *ppDisp como NULL. Em caso de êxito, o chamador é responsável por chamar Release quando *ppDisp não é mais necessário.

Retornar valor

Esse método pode retornar os valores retornados padrão E_OUTOFMEMORY e E_UNEXPECTED, bem como os valores a seguir.

Código de retorno Descrição
S_OK
 O método foi concluído com sucesso.
E_NOTIMPL
 O contêiner não implementa controles estendidos.
E_POINTER
 O endereço em ppDisp ou *ppDisp não é válido. Por exemplo, pode ser NULL.

Comentários

Esse método fornece ao controle real acesso a quaisquer propriedades e métodos que o contêiner mantém no controle estendido. Essas propriedades e métodos seriam inacessíveis ao controle.

Anotações aos Chamadores

O ponteiro retornado é responsabilidade do chamador, que deve liberá-lo quando ele não for mais necessário.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho ocidl.h

Confira também

Iolecontrolsite