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

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

See also

UuidCreate