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 以降で使用できます。 |
対象プラットフォーム | ユニバーサル |
Header | wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む) |
Library | NtosKrnl.lib |
[DLL] | NtosKrnl.exe (カーネル モード);Ntdll.dll (ユーザー モード) |
IRQL | PASSIVE_LEVEL |