ExUuidCreate function

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

Syntax

NTSTATUS ExUuidCreate(
  UUID *Uuid
);

Parameters

Uuid

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 code Description
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

   
Minimum supported client Available starting with Windows 2000.
Target Platform Universal
Header ntddk.h (include Ntddk.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
DDI compliance rules IrqlExPassive, PowerIrpDDis, HwStorPortProhibitedDDIs