Metodo IDataModelManager2::CreateErrorObject (dbgmodel.h)

Il metodo CreateErrorObject crea un "oggetto error". Il modello di dati non ha la nozione di eccezioni e flusso di eccezioni. L'errore esce da una proprietà o da un metodo in due modi:

• Un singolo HRESULT con errore non riuscito senza informazioni di errore estese. Non sono disponibili altre informazioni che possono essere fornite per l'errore o l'errore stesso è autoesplicativo dall'HRESULT restituito.

• Un singolo HRESULT con errore singolo abbinato a informazioni di errore estese. Le informazioni estese sull'errore sono un oggetto di errore restituito nell'argomento di output della proprietà/metodo.

Sintassi

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

Parametri

hrError

Codice di errore per il quale vengono create le informazioni estese sull'errore. Se una determinata funzione è l'entità che crea un oggetto errore per un errore, questo codice deve corrispondere a HRESULT non riuscito restituito dalla funzione.

pwszMessage

Un messaggio facoltativo che fornisce un'indicazione più approfondita di ciò che non è riuscito e perché. Questo messaggio sarà la conversione della stringa di visualizzazione dell'oggetto errore creato.

object

L'oggetto errore appena costruito/boxed verrà restituito qui.

Valore restituito

Questo metodo restituisce HRESULT.

Osservazioni

codice di esempio

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.
}

Fabbisogno

Requisito	Valore
intestazione	dbgmodel.h

Vedere anche

dell'interfaccia IDataModelManager2