CoCreateGuid
Creates a
GUID, a unique 128-bit integer used for CLSIDs and interface identifiers.
HRESULT CoCreateGuid(
|
GUID *pguid |
//Pointer to the GUID on return |
|
); |
|
Parameter
pguid
[out] Pointer
to the requested GUID on return.
Return Value
S_OK
The GUID was
successfully created.
Win32 errors
are returned by UuidCreate
but wrapped as an HRESULT.
Remarks
The CoCreateGuid
function calls the RPC function UuidCreate, which creates a GUID, a
globally unique 128-bit integer. Use the CoCreateGuid function 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.
See Also