Función SetupDiClassNameFromGuidW (setupapi.h)

  • Artículo

La función SetupDiClassNameFromGuid recupera el nombre de clase asociado a un GUID de clase.

Sintaxis

WINSETUPAPI BOOL SetupDiClassNameFromGuidW(
  [in]            const GUID *ClassGuid,
  [out]           PWSTR      ClassName,
  [in]            DWORD      ClassNameSize,
  [out, optional] PDWORD     RequiredSize
);

Parámetros

[in] ClassGuid

Puntero al GUID de clase para el nombre de clase que se va a recuperar.

[out] ClassName

Puntero a un búfer que recibe la cadena terminada en NULL que contiene el nombre de la clase especificada por el puntero en el parámetro ClassGuid .

[in] ClassNameSize

Tamaño, en caracteres, del búfer al que apunta el parámetro ClassName . El tamaño máximo, en caracteres, de un nombre de clase terminada en NULL es MAX_CLASS_NAME_LEN. Para obtener más información sobre el tamaño del nombre de clase, vea la siguiente sección Comentarios .

[out, optional] RequiredSize

Puntero a una variable que recibe el número de caracteres necesarios para almacenar el nombre de clase terminado en NULL solicitado. Este puntero es opcional y puede ser NULL.

Valor devuelto

La función devuelve TRUE si se realiza correctamente. De lo contrario, devuelve FALSE y el error registrado se puede recuperar con una llamada a GetLastError.

Comentarios

Llame a SetupDiClassNameFromGuidEx para recuperar el nombre de una clase en un equipo remoto.

SetupDiClassNameFromGuid no aplica una restricción en la longitud del nombre de clase que puede devolver. Esta función devuelve el tamaño necesario para un nombre de clase terminada en NULL incluso si es mayor que MAX_CLASS_NAME_LEN. Sin embargo, MAX_CLASS_NAME_LEN es la longitud máxima de un nombre de clase terminado en NULL válido. Un llamador nunca debe necesitar un búfer que sea mayor que MAX_CLASS_NAME_LEN. Para obtener más información sobre los nombres de clase, vea la descripción de la entrada Class de una sección INF Version .

Nota

El encabezado setupapi.h define SetupDiClassNameFromGuid como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible en Microsoft Windows 2000 y versiones posteriores de Windows.
Plataforma de destino Escritorio
Encabezado setupapi.h (incluya Setupapi.h)
Library Setupapi.lib

Consulte también

SetupDiClassGuidsFromName

SetupDiClassNameFromGuidEx