Export (0) Print
Expand All
Expand Minimize

UuidCreateSequential function

The UuidCreateSequential function creates a new UUID.

Syntax


RPC_STATUS RPC_ENTRY UuidCreateSequential(
  UUID __RPC_FAR *Uuid
);

Parameters

Uuid

Returns a pointer to the created UUID.

Return value

ValueMeaning
RPC_S_OK

The call succeeded.

RPC_S_UUID_LOCAL_ONLY

The UUID is guaranteed to be unique to this computer only. For more information please see: KB article 981080.

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

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Rpcdce.h (include Rpc.h)

Library

Rpcrt4.lib

DLL

Rpcrt4.dll

See also

UuidCreate
UuidFromString
UuidToString

 

 

Community Additions

ADD
Show:
© 2014 Microsoft