Edit

Share via

UuidCreateSequential function (rpcdce.h)

  • Article
  • 02/22/2024

The UuidCreateSequential function creates a new UUID.

Syntax

RPC_STATUS UuidCreateSequential(
  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, UuidCreate was modified so that it no longer uses a machine's MAC address to generate UUIDs. UuidCreateSequential was introduced to allow creation of UUIDs using the MAC address of a machine's Ethernet card.

The UuidCreateSequential function returns RPC_S_UUID_LOCAL_ONLY when the originating computer does not have an ethernet/token ring (IEEE 802.x) address. In this case, the generated UUID is a valid identifier, and is guaranteed to be unique among all UUIDs generated on the computer. However, the possibility exists that another computer without an ethernet/token ring address generated the identical UUID. Therefore you should never use this UUID to identify an object that is not strictly local to your computer. Computers with ethernet/token ring addresses generate UUIDs that are guaranteed to be globally unique.

Note  The UuidCreateSequential function tends to be slightly faster than the UuidCreate function. When the performance of the generation of a UUID is a significant consideration, the UuidCreateSequential function may be used.
 

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

See also

UuidCreate

UuidFromString

UuidToString

Additional resources