Bagikan melalui

Struktur EXCEPINFO (oaidl.h)

  • Artikel

Menjelaskan pengecualian yang terjadi selama IDispatch::Invoke.

Sintaks

typedef struct tagEXCEPINFO {
  WORD      wCode;
  WORD      wReserved;
  BSTR      bstrSource;
  BSTR      bstrDescription;
  BSTR      bstrHelpFile;
  DWORD     dwHelpContext;
  ULONG_PTR pvReserved;
  ULONG_PTR pfnDeferredFillIn;
  SCODE     scode;
} EXCEPINFO, *LPEXCEPINFO;

Anggota

wCode

Kode kesalahan. Kode kesalahan harus lebih besar dari 1000. Bidang ini atau bidang scode harus diisi; yang lain harus diatur ke 0.

wReserved

Dicadangkan. Harus 0.

bstrSource

Nama sumber pengecualian. Biasanya, ini adalah nama aplikasi. Bidang ini harus diisi oleh pelaksana IDispatch.

bstrDescription

Deskripsi pengecualian untuk ditampilkan. Jika tidak ada deskripsi yang tersedia, gunakan null.

bstrHelpFile

Jalur file bantuan yang sepenuhnya memenuhi syarat. Jika tidak ada Bantuan yang tersedia, gunakan null.

dwHelpContext

ID konteks bantuan.

pvReserved

Dicadangkan. Harus null.

pfnDeferredFillIn

Menyediakan pengisian yang ditangguhkan. Jika pengisian yang ditangguhkan tidak diinginkan, bidang ini harus diatur ke null.

scode

Nilai pengembalian yang menjelaskan kesalahan. Baik bidang ini atau wCode (tetapi tidak keduanya) harus diisi; yang lain harus diatur ke 0. (hanya versi Windows 16-bit.)

Keterangan

Gunakan bidang pfnDeferredFillIn untuk mengaktifkan objek untuk menunda pengisian bidang bstrDescription, bstrHelpFile, dan dwHelpContext hingga diperlukan. Bidang ini mungkin digunakan, misalnya, jika memuat string untuk kesalahan adalah operasi yang memakan waktu. Untuk menggunakan pengisian yang ditangguhkan, objek menempatkan penunjuk fungsi di slot ini dan tidak mengisi bidang lain kecuali wCode, yang diperlukan.

Untuk mendapatkan informasi tambahan, pemanggil meneruskan struktur EXCEPINFO kembali ke fungsi panggilan balik pexcepinfo , yang mengisi informasi tambahan. Ketika objek ActiveX dan klien ActiveX berada dalam proses yang berbeda, objek ActiveX memanggil pfnDeferredFillIn sebelum kembali ke pengontrol.

Persyaratan

Persyaratan Nilai
Header oaidl.h