Skip to content

Latest commit

 

History

History
101 lines (74 loc) · 3.66 KB

nf-setupapi-setupdiclassnamefromguidexa.md

File metadata and controls

101 lines (74 loc) · 3.66 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:setupapi.SetupDiClassNameFromGuidExA
SetupDiClassNameFromGuidExA function (setupapi.h)
The SetupDiClassNameFromGuidEx function retrieves the class name associated with a class GUID. The class can be installed on a local or remote computer. (ANSI)
SetupDiClassNameFromGuidExA
di-rtns_69da61fd-b042-4b1b-92a4-d40418f18794.xml
devinst\setupdiclassnamefromguidex.htm
devinst
0d576df1-e259-4025-8ef0-a520f5680fa0
01/30/2023
SetupDiClassNameFromGuidEx, SetupDiClassNameFromGuidEx function [Device and Driver Installation], SetupDiClassNameFromGuidExA, SetupDiClassNameFromGuidExW, devinst.setupdiclassnamefromguidex, di-rtns_69da61fd-b042-4b1b-92a4-d40418f18794.xml, setupapi/SetupDiClassNameFromGuidEx
setupapi.h
Setupapi.h
Desktop
Available in Microsoft Windows 2000 and later versions of Windows.
Setupapi.lib
Windows
19H1
SetupDiClassNameFromGuidExA
setupapi/SetupDiClassNameFromGuidExA
c++
APIRef
kbSyntax
LibDef
Setupapi.lib
Setupapi.dll
SetupDiClassNameFromGuidEx
SetupDiClassNameFromGuidExA

SetupDiClassNameFromGuidExA function

-description

The SetupDiClassNameFromGuidEx function retrieves the class name associated with a class GUID. The class can be installed on a local or remote computer.

-parameters

-param ClassGuid [in]

The class GUID of the class name to retrieve.

-param ClassName [out]

A pointer to a string buffer that receives the NULL-terminated name of the class for the specified GUID.

-param ClassNameSize [in]

The size, in characters, of the ClassName buffer.

-param RequiredSize [out, optional]

The number of characters required to store the class name (including a terminating null). RequiredSize is always less than MAX_CLASS_NAME_LEN.

-param MachineName [in, optional]

A pointer to a NULL-terminated string that contains the name of a remote system on which the class is installed. This parameter is optional and can be NULL. If MachineName is NULL, the local system name is used.

Caution

Using this function to access remote machines is not supported beginning with Windows 8 and Windows Server 2012, as this functionality has been removed.

-param Reserved

Must be NULL.

-returns

The function returns TRUE if it is successful. Otherwise, it returns FALSE and the logged error can be retrieved with a call to GetLastError.

-see-also

SetupDiClassGuidsFromNameEx

SetupDiClassNameFromGuid

-remarks

Note

The setupapi.h header defines SetupDiClassNameFromGuidEx as an alias which automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.