EXCEPINFO

9/8/2008

Essa estrutura descreve uma exceção que ocorreu durante IDispatch::Invoke.

Syntax

typedef struct FARSTRUCT tagEXCEPINFO {
  unsigned short wCode;
  unsigned short wReserved;
  BSTR bstrSource;
  BSTR bstrDescription;
  BSTR bstrHelpFile;
  unsigned long dwHelpContext;
  void FAR *pvReserved;
  HRESULT (STDAPICALLTYPE FAR* pfnDeferredFillIn) 
          (struct tagEXCEPINFO FAR *);
  SCODE scode;
} EXCEPINFO;

Os membros

• wCode
  Código que identifica o erro. Códigos de erro devem ser maiores que 1000. Esse membro é exigido.

• wReserved
  Reservado; Defina como 0.

• bstrSource
  Seqüência de caracteres Unicode que contém o nome textual, Human-Readable da origem da exceção. Normalmente, este é um nome do aplicativo. Este membro deve ser preenchido pelo implementador de IDispatch.

• bstrDescription
  Seqüência de caracteres Unicode que contém a descrição textual, Human-Readable do erro destinado o cliente. Se nenhuma descrição está disponível, usar NULL.

• bstrHelpFile
  Seqüência de caracteres Unicode que contém a unidade totalmente qualificado, caminho e nome arquivo de um arquivo da Ajuda com mais informações sobre o erro. Se nenhuma ajuda está disponível, usar NULL.

• dwHelpContext
  Especifica o identificador de contexto ' ajuda ' do tópico dentro de arquivo da Ajuda. Este membro deve ser preenchido se e somente se o bstrHelpFile membro não é NULL.

• pvReserved
  Reservado; Definir como NULL.

• pfnDeferredFillIn
  Ponteiro para uma função que leva um EXCEPINFO estrutura como um argumento e retorna um HRESULT valor. Passar NULL para não usar preenchimento adiado das EXCEPINFO estrutura. Para obter mais informações, consulte " Comentários ".

• SCode
  Deve ser definido como 0. Não usado. Um herdado resíduo de 16-bit Windows API.

Remarks

Use o pfnDeferredFillIn membro para permitir que um objeto para adiar preencher os bstrDescription, bstrHelpFile, e dwHelpContext Membros até que eles são necessários. Esse membro pode ser usado, de exemplo, se carregar o seqüência de caracteres para o erro é uma operação demorada. Para usar preenchimento Adiado, o objeto coloca um ponteiro de função nesse slot e não preencher alguns dos outros membros, exceto wCode, que é exigido.

Para informações adicionais get, a chamador passa a EXCEPINFO estrutura voltar para o pexcepinfo função callback, que preencha as informações adicionais. Quando o objeto ActiveX e o cliente ActiveX estiverem em processos diferentes, o objeto ActiveX chamadas pfnDeferredFillIn Antes de retornar para o controlador.

Requirements

Header	oaidl.h
Windows Embedded CE	Windows CE 2.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

Automation Structures
IDispatch::Invoke