rtlStringFromGUID 函数 (wdm.h)

  • 项目

RtlStringFromGUID 例程将给定 GUID 从二进制格式转换为 Unicode 字符串。

语法

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）
Library NtosKrnl.lib
DLL NtosKrnl.exe (内核模式) ;Ntdll.dll (用户模式)
IRQL PASSIVE_LEVEL

另请参阅

RtlGUIDFromString