SetupDiClassNameFromGuidA 函式 (setupapi.h)
SetupDiClassNameFromGuid 函式會擷取與類別 GUID 相關聯的類別名稱。
語法
WINSETUPAPI BOOL SetupDiClassNameFromGuidA(
[in] const GUID *ClassGuid,
[out] PSTR ClassName,
[in] DWORD ClassNameSize,
[out, optional] PDWORD RequiredSize
);
參數
[in] ClassGuid
要擷取之類別名稱之類別 GUID 的指標。
[out] ClassName
緩衝區的指標，接收NULL終止字元串，其中包含 ClassGuid 參數中指標所指定的類別名稱。
[in] ClassNameSize
ClassName 參數所指向之緩衝區的大小，以字元為單位。 NULL 終止類別名稱的大小上限為 MAX_CLASS_NAME_LEN。 如需類別名稱大小的詳細資訊，請參閱下列 一 節。
[out, optional] RequiredSize
變數的指標，可接收儲存所要求 NULL 終止類別名稱所需的字元數。 此指標是選擇性的，可以是 NULL。
傳回值
如果函式成功，函式會傳回 TRUE 。 否則，它會傳回 FALSE ，而且可以透過呼叫 GetLastError 來擷取記錄的錯誤。
備註
呼叫 SetupDiClassNameFromGuidEx 以擷取遠端電腦上的類別名稱。
SetupDiClassNameFromGuid 不會對可以傳回的類別名稱長度強制執行限制。 此函式會傳回 NULL 終止類別名稱所需的大小，即使大於MAX_CLASS_NAME_LEN也一樣。 不過，MAX_CLASS_NAME_LEN是有效 NULL 終止類別名稱的最大長度。 呼叫端絕對不需要大於MAX_CLASS_NAME_LEN的緩衝區。 如需類別名稱的詳細資訊，請參閱 INF 版本類別專案的描述一節。
注意
setupapi.h 標頭會根據 UNICODE 預處理器常數的定義，將 SetupDiClassNameFromGuid 定義為別名，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 可在 Microsoft Windows 2000 和更新版本的 Windows 中使用。 |
| 目標平台 | 桌面 |
| 標頭 | setupapi.h (包括 Setupapi.h) |
| 程式庫 | Setupapi.lib |