The
UuidCreate function creates a new
UUID.
Syntax
RPC_STATUS RPC_ENTRY UuidCreate(
UUID __RPC_FAR *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 |
|---|
| Minimum supported server | Windows 2000 Server |
|---|
| Header | Rpcdce.h (include Rpc.h) |
|---|
| Library | Rpcrt4.lib |
|---|
| DLL | Rpcrt4.dll |
|---|
See Also
- UuidFromString
- UuidToString
Send comments about this topic to Microsoft
Build date: 5/28/2009