Export (0) Print
Expand All
Expand Minimize

RtlStringFromGUID routine

The RtlStringFromGUID routine converts a given GUID from binary format into a Unicode string.

Syntax


NTSTATUS RtlStringFromGUID(
  _In_   REFGUID Guid,
  _Out_  PUNICODE_STRING GuidString
);

Parameters

Guid [in]

Specifies the binary-format GUID to convert.

GuidString [out]

Pointer to a caller-supplied variable in which a pointer to the converted GUID string is returned. RtlStringFromGUID allocates the buffer space for the string, which the caller must free by calling RtlFreeUnicodeString.

Return value

If the conversion succeeds, RtlStringFromGUID returns STATUS_SUCCESS. Otherwise, no storage was allocated, nor was the conversion performed.

Requirements

Version

Available starting with Windows 2000.

Header

Wdm.h (include Wdm.h, Ntddk.h, or Ntifs.h)

Library

Ntoskrnl.lib

IRQL

PASSIVE_LEVEL

See also

RtlGUIDFromString

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft