UuidCreate function (rpcdce.h)
The UuidCreate function creates a new UUID.
Syntax
RPC_STATUS UuidCreate(
UUID *Uuid
);
Parameters
Uuid
Returns a pointer to the created UUID.
Return value
| Value | Meaning |
|---|---|
|
The call succeeded. |
|
The UUID is guaranteed to be unique to this computer only. |
|
Cannot get Ethernet or token-ring hardware address for this computer. |
Note For a list of valid error codes, see
RPC Return Values.
Remarks
For security reasons, it is often desirable to keep ethernet addresses on networks from becoming available outside a company or organization. The UuidCreate function generates a UUID that cannot be traced to the ethernet address of the computer on which it was generated. It also cannot be associated with other UUIDs created on the same computer. If you do not need this level of security, your application can use the UuidCreateSequential function, which behaves exactly as the UuidCreate function does on all other versions of the operating system.
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 | rpcdce.h (include Rpc.h) |
| Library | Rpcrt4.lib |
| DLL | Rpcrt4.dll |