UuidCreate function

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
RPC_S_OK
The call succeeded.
RPC_S_UUID_LOCAL_ONLY
The UUID is guaranteed to be unique to this computer only.
RPC_S_UUID_NO_ADDRESS
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

   
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

See Also

UuidFromString

UuidToString