ICreateErrorInfo::SetGUID

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This method sets the globally unique identifier (GUID) of the interface that defined the error.

Syntax

HRESULT SetGUID( 
  REFGUID rguid
);

Parameters

  • rguid
    [in] GUID of the interface that defined the error, or GUID_NULL if the error was defined by the operating system.

Return Value

If the method succeeds, the return value is S_OK.

If there is insufficient memory to complete the operation, the return value is E_OUTOFMEMORY.

Remarks

SetGUID sets the GUID of the interface that defined the error. If the error was defined by the system, set SetGUID to GUID_NULL.

This GUID does not necessarily represent the source of the error; however, the source is the class or application that raised the error. Using the GUID, applications can handle errors in an interface, independent of the class that implements the interface.

Example

hr = CreateErrorInfo(&pcerrinfo);
pcerrinfo->SetGUID(IID_IHello);

Requirements

Header oaidl.h, oaidl.idl
Library oleaut32.lib, uuid.lib
Windows Embedded CE Windows CE 2.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

ICreateErrorInfo