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
| Return code | Description |
|---|---|
|
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 |