CoCreateGuid function (combaseapi.h)

Creates a GUID, a unique 128-bit integer used for CLSIDs and interface identifiers.


HRESULT CoCreateGuid(
  [out] GUID *pguid


[out] pguid

A pointer to the requested GUID.

Return value

Return code Description
The GUID was successfully created.

Errors returned by UuidCreate are wrapped as an HRESULT.


The CoCreateGuid function calls the RPC function UuidCreate, which creates a GUID, a globally unique 128-bit integer. Use CoCreateGuid when you need an absolutely unique number that you will use as a persistent identifier in a distributed environment. To a very high degree of certainty, this function returns a unique value – no other invocation, on the same or any other system (networked or not), should return the same value.


Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps | UWP apps]
Minimum supported server Windows 2000 Server [desktop apps | UWP apps]
Target Platform Windows
Header combaseapi.h (include Objbase.h)
Library Ole32.lib
DLL Ole32.dll

See also