IDataModelManager4::CreateErrorObject-Methode (dbgmodel.h)
Die CreateErrorObject-Methode erstellt ein "Error-Objekt". Das Datenmodell hat nicht den Begriff der Ausnahmen und des Ausnahmeflusses. Fehler kommt aus einer Eigenschaft/Methode auf zwei Arten:
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 selbsterklärend vom zurückgegebenen HRESULT.
Ein einzelnes fehlerhaftes HRESULT gekoppelt mit erweiterten Fehlerinformationen. 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/boxed-Fehlerobjekt wird hier zurückgegeben.
Rückgabewert
Diese Methode gibt HRESULT zurück.
Bemerkungen
Beispielcode-
ComPtr<IDataModelManager4> 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 |