共用方式為

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

另請參閱

SetupDiClassGuidsFromName

SetupDiClassNameFromGuidEx