CoCreateGuid function

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

Syntax

HRESULT CoCreateGuid(
  GUID *pguid
);

Parameters

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

   
Windows version Windows 2000 Professional [desktop apps | UWP apps] 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