Função CoGetInterceptor (callobj.h)

Artigo
02/23/2024

Cria uma instância do interceptador apropriado para que a interface especificada seja interceptada e retorna o interceptador recém-criado.

Sintaxe

HRESULT CoGetInterceptor(
  [in]  REFIID   iidIntercepted,
  [in]  IUnknown *punkOuter,
  [in]  REFIID   iid,
  [out] void     **ppv
);

Parâmetros

[in] iidIntercepted

Uma referência ao identificador da interface para a qual um interceptador deve ser retornado.

[in] punkOuter

Se esse parâmetro for NULL, o objeto não será criado como parte de uma agregação. Caso contrário, esse parâmetro é um ponteiro para a interface IUnknown do objeto agregado (o IUnknown controlador).

[in] iid

Uma referência ao identificador da interface desejada no interceptador.

[out] ppv

O endereço de uma variável de ponteiro que recebe o ponteiro de interface solicitado em iid. Após o retorno bem-sucedido, **ppv contém o ponteiro do interceptador solicitado.

Retornar valor

Essa função pode retornar os valores a seguir.

Código de retorno	Descrição
S_OK	A função foi retornada com êxito.
E_UNEXPECTED	Erro inesperado.

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	callobj.h
Biblioteca	Ole32.lib
DLL	Ole32.dll

Confira também