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

Syntax

HRESULT CoCreateGuid(
  __out  GUID *pguid
);

Parameters

pguid [out]

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

Send comments about this topic to Microsoft

Build date: 10/22/2009