RtlStringFromGUID-Funktion (wdm.h)

  • Artikel

Die RtlStringFromGUID-Routine konvertiert eine bestimmte GUID aus dem Binärformat in eine Unicode-Zeichenfolge.

Syntax

NTSYSAPI NTSTATUS RtlStringFromGUID(
  [in]  REFGUID         Guid,
  [out] PUNICODE_STRING GuidString
);

Parameter

[in] Guid

Gibt die zu konvertierende GUID im Binärformat an.

[out] GuidString

Zeiger auf eine vom Aufrufer bereitgestellte Variable, in der ein Zeiger auf die konvertierte GUID-Zeichenfolge zurückgegeben wird. RtlStringFromGUID weist den Pufferraum für die Zeichenfolge zu, den der Aufrufer durch Aufrufen von RtlFreeUnicodeString freigeben muss. Die zurückgegebene Zeichenfolge hat das Format {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}, einschließlich der vorangestellten und angefügten Klammern.

Rückgabewert

Wenn die Konvertierung erfolgreich ist, gibt RtlStringFromGUID STATUS_SUCCESS zurück. Andernfalls wurde kein Speicher zugewiesen, noch wurde die Konvertierung durchgeführt.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar ab Windows 2000.
Zielplattform Universell
Header wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)
Bibliothek NtosKrnl.lib
DLL NtosKrnl.exe (Kernelmodus); Ntdll.dll (Benutzermodus)
IRQL PASSIVE_LEVEL

Weitere Informationen

RtlGUIDFromString