UuidCreateSequential function
Applies to: desktop apps only
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
| Value | Meaning |
|---|---|
|
The call succeeded. |
|
The UUID is guaranteed to be unique to this computer only. For more information please see: KB article 981080. |
|
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 |
|---|---|
|
Minimum supported server | Windows 2000 Server |
|
Header |
|
|
Library |
|
|
DLL |
|
See also
Send comments about this topic to Microsoft
Build date: 3/6/2012
