Export (0) Print
Expand All
Expand Minimize

SetupDiClassNameFromGuidEx function

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

Syntax


BOOL SetupDiClassNameFromGuidEx(
  _In_       const GUID   *ClassGuid,
  _Out_            PTSTR  ClassName,
  _In_             DWORD  ClassNameSize,
  _Out_opt_        PDWORD RequiredSize,
  _In_opt_         PCTSTR MachineName,
  _Reserved_       PVOID  Reserved
);

Parameters

ClassGuid [in]

The class GUID of the class name to retrieve.

ClassName [out]

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

ClassNameSize [in]

The size, in characters, of the ClassName buffer.

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.

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.

Reserved

Must be NULL.

Return value

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

Requirements

Target platform

Desktop

Version

Available in Microsoft Windows 2000 and later versions of Windows.

Header

Setupapi.h (include Setupapi.h)

Library

Setupapi.lib

See also

SetupDiClassGuidsFromNameEx
SetupDiClassNameFromGuid

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft