Функция RtlStringFromGUID (wdm.h)

  • Статья

Подпрограмма RtlStringFromGUID преобразует заданный GUID из двоичного формата в строку Юникода.

Синтаксис

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

Параметры

[in] Guid

Указывает преобразуемый идентификатор GUID двоичного формата.

[out] GuidString

Указатель на переменную, предоставленную вызывающим, в которой возвращается указатель на преобразованную строку GUID. RtlStringFromGUID выделяет буферное пространство для строки, которую вызывающий объект должен освободить, вызвав RtlFreeUnicodeString. Возвращаемая строка имеет вид {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}, включая добавленные и добавленные фигурные скобки.

Возвращаемое значение

Если преобразование выполнено успешно, функция RtlStringFromGUID возвращает STATUS_SUCCESS. В противном случае хранилище не было выделено, и преобразование не выполнялось.

Требования

Требование Значение
Минимальная версия клиента Доступно начиная с Windows 2000.
Целевая платформа Универсальное
Верхняя часть wdm.h (включая Wdm.h, Ntddk.h, Ntifs.h)
Библиотека NtosKrnl.lib
DLL NtosKrnl.exe (режим ядра); Ntdll.dll (пользовательский режим)
IRQL PASSIVE_LEVEL

См. также раздел

RtlGUIDFromString