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 |