Expand Minimize

ExUuidCreate routine

The ExUuidCreate routine initializes a UUID (GUID) structure to a newly generated value.

Syntax


NTSTATUS ExUuidCreate(
  _Out_ UUID *Uuid
);

Parameters

Uuid [out]

A pointer to a caller-allocated UUID (GUID) structure that is set to a new UUID value.

Return value

Possible return values include the following status codes.

Return codeDescription
STATUS_SUCCESS

The routine successfully generated a UUID that is universally unique.

RPC_NT_UUID_LOCAL_ONLY

The routine generated a UUID that is unique only to this computer. This can occur when the MAC address is not an IEEE universally-administered address or when no NICs are present.

STATUS_RETRY

The system is not ready to generate a new UUID.

 

Remarks

A UUID and a GUID are the same data type.

The caller can iteratively attempt to obtain a new UUID value.

Requirements

Target platform

Universal

Version

Available starting with Windows 2000.

Header

Ntddk.h (include Ntddk.h)

Library

Ntoskrnl.lib

IRQL

PASSIVE_LEVEL

DDI compliance rules

IrqlExPassive, PowerIrpDDis, HwStorPortProhibitedDDIs

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft