IDataModelManager2::CreateErrorObject-Methode (dbgmodel.h)
Die CreateErrorObject-Methode erstellt ein "Error-Objekt". Das Datenmodell verfügt nicht über das Konzept von Ausnahmen und Ausnahmefluss. Fehler treten aus einer Eigenschaft/Methode auf zwei Arten auf:
Ein einzelnes fehlerhaftes HRESULT ohne erweiterte Fehlerinformationen. Entweder gibt es keine weiteren Informationen, die für den Fehler angegeben werden können, oder der Fehler selbst ist aus dem zurückgegebenen HRESULT selbsterklärend.
Ein einzelnes fehlerhaftes HRESULT,das mit erweiterten Fehlerinformationen gekoppelt ist. Die erweiterten Fehlerinformationen sind ein Fehlerobjekt, das im Ausgabeargument der Eigenschaft/Methode zurückgegeben wird.
Syntax
HRESULT CreateErrorObject(
HRESULT hrError,
PCWSTR pwszMessage,
IModelObject **object
);
Parameter
hrError
Der Fehlercode, für den die erweiterten Fehlerinformationen erstellt werden. Wenn eine bestimmte Funktion die Entität ist, die ein Fehlerobjekt für einen Fehler erstellt, muss dieser Code mit dem fehlerhaften HRESULT übereinstimmen, das von der Funktion zurückgegeben wird.
pwszMessage
Eine optionale Meldung, die einen tieferen Hinweis darauf gibt, was fehlgeschlagen ist und warum. Diese Meldung ist die Anzeigezeichenfolgenkonvertierung des erstellten Fehlerobjekts.
object
Das neu erstellte/geschachtelte Fehlerobjekt wird hier zurückgegeben.
Rückgabewert
Diese Methode gibt HRESULT zurück.
Hinweise
Beispielcode
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.
}
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | dbgmodel.h |