Edit

Share via

RtlGUIDFromString function (wdm.h)

  • Article

The RtlGUIDFromString routine converts the given Unicode string to a GUID in binary format.

Syntax

NTSYSAPI NTSTATUS RtlGUIDFromString(
  [in]  PCUNICODE_STRING GuidString,
  [out] GUID             *Guid
);

Parameters

[in] GuidString

Pointer to the buffered Unicode string to be converted to a GUID. The string should be in the following form (including the braces): {00000000-0000-0000-0000-000000000000}

[out] Guid

Pointer to a caller-supplied variable in which the GUID is returned.

Return value

If the conversion succeeds, RtlGUIDFromString returns STATUS_SUCCESS. Otherwise, no conversion was done.

Requirements

Requirement Value
Minimum supported client Available starting with Windows 2000.
Target Platform Universal
Header wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe (kernel mode); Ntdll.dll (user mode)
IRQL PASSIVE_LEVEL

See also

RtlStringFromGUID