Metode IDataModelManager2::CreateErrorObject (dbgmodel.h)

Metode CreateErrorObject membuat "objek kesalahan". Model data tidak memiliki gagasan pengecualian dan alur pengecualian. Kegagalan keluar dari properti/metode dengan dua cara:

  • Satu HRESULT yang gagal tanpa informasi kesalahan yang diperluas. Baik tidak ada informasi lagi yang dapat diberikan untuk kesalahan atau kesalahan itu sendiri adalah penjelasan mandiri dari HRESULT yang dikembalikan.

  • Satu HRESULT yang gagal digabungkan dengan informasi kesalahan yang diperluas. Informasi kesalahan yang diperluas adalah objek kesalahan yang dikembalikan dalam argumen output properti/metode.

Sintaks

HRESULT CreateErrorObject(
  HRESULT      hrError,
  PCWSTR       pwszMessage,
  IModelObject **object
);

Parameter

hrError

Kode kesalahan tempat informasi kesalahan yang diperluas sedang dibuat. Jika fungsi tertentu adalah entitas yang membuat objek kesalahan untuk kegagalan, kode ini harus cocok dengan HRESULT yang gagal yang dikembalikan oleh fungsi.

pwszMessage

Pesan opsional yang memberikan indikasi yang lebih dalam tentang apa yang gagal dan mengapa. Pesan ini akan menjadi konversi string tampilan dari objek kesalahan yang dibuat.

object

Objek kesalahan yang baru dibuat/dikotak akan dikembalikan di sini.

Mengembalikan nilai

Metode ini mengembalikan HRESULT.

Keterangan

Kode Sampel

ComPtr<IDataModelManager> spManager; /* get the data model manager */

ComPtr<IModelObject> spError;
if (SUCCEEDED(spManager->CreateErrorObject(
    E_INVALIDARG, 
    L"Calls to the Sum() method must pass at least one argument", 
    &spError)))
{
    // You can pass this back in places where you see 
    // _COM_Errorptr_ annotated.  Methods, for instance, may return 
    // E_INVALIDARG and an error object to channel out additional information.
    // Property accessor GetValue implementations can also do this.  
    // Indexers can do this.
}

Persyaratan

Persyaratan Nilai
Header dbgmodel.h

Lihat juga

Antarmuka IDataModelManager2