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