UuidCreateSequential function (rpcdce.h)

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