ICreateErrorInfo::SetGUID

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

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 Values

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

OS Versions: Windows CE 2.0 and later.
Header: Oaidl.h, Oaidl.idl.
Link Library: Oleaut32.lib, Uuid.lib.

See Also

ICreateErrorInfo

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.