Edit

CoCreateGuid function (combaseapi.h)

  • Article

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