RtlStringFromGUID-Funktion (wdm.h)
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 |