ICreateErrorInfo::SetGUID-Methode (oaidl.h)
Legt den globalen eindeutigen Bezeichner (GUID) der Schnittstelle fest, die den Fehler definiert hat.
Syntax
HRESULT SetGUID(
[in] REFGUID rguid
);
Parameter
[in] rguid
Die GUID der Schnittstelle, die den Fehler definiert hat, oder GUID_NULL, wenn der Fehler vom Betriebssystem definiert wurde.
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
Rückgabecode | BESCHREIBUNG |
---|---|
|
Erfolg. |
|
Unzureichender Arbeitsspeicher, um den Vorgang abzuschließen. |
Hinweise
Diese Methode legt die GUID der Schnittstelle fest, die den Fehler definiert hat. Wenn der Fehler vom System definiert wurde, legen Sie ICreateErrorInfo::SetGUID auf GUID_NULL fest.
Diese GUID stellt nicht unbedingt die Fehlerquelle dar. Die Quelle ist jedoch die Klasse oder Anwendung, die den Fehler ausgelöst hat. Mithilfe der GUID können Anwendungen Fehler in einer Schnittstelle behandeln, unabhängig von der Klasse, die die Schnittstelle implementiert.
Die Verwendung dieser Funktion wird in der Datei Main.cpp des Com Fundamentals Hello-Beispiels veranschaulicht.
Anforderungen
Anforderung | Wert |
---|---|
Zielplattform | Windows |
Kopfzeile | oaidl.h |