Export (0) Print
Expand All
Expand Minimize
4 out of 13 rated this helpful - Rate this topic

UuidCreate function

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

ValueMeaning
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 [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

UuidFromString
UuidToString

 

 

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.