CoCreateGuid function (combaseapi.h)

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

Syntax

HRESULT CoCreateGuid(
  [out] GUID *pguid
);

Parameters

[out] pguid

A pointer to the requested GUID.

Return value

Return code	Description
S_OK	The GUID was successfully created.

 

Errors returned by UuidCreate are wrapped as an HRESULT.

Remarks

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.

Requirements

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

UuidCreate