Método IPortableDeviceManager::GetDeviceManufacturer (portabledeviceapi.h)

  • Artículo

Recupera el nombre del fabricante del dispositivo.

Sintaxis

HRESULT GetDeviceManufacturer(
  [in]      LPCWSTR pszPnPDeviceID,
  [in, out] WCHAR   *pDeviceManufacturer,
  [in, out] DWORD   *pcchDeviceManufacturer
);

Parámetros

[in] pszPnPDeviceID

Puntero a una cadena terminada en null que contiene el identificador de Plug and Play del dispositivo. Puede recuperar una lista de Plug and Play nombres de todos los dispositivos conectados al equipo mediante una llamada a GetDevices.

[in, out] pDeviceManufacturer

Búfer asignado por el autor de la llamada que contiene el nombre del fabricante del dispositivo. Para conocer el tamaño necesario para este parámetro, llame primero a este método con este parámetro establecido en NULL y pcchDeviceManufacturer establecido en 0; El método se realizará correctamente y establecerá pcchDeviceManufacturer en el tamaño de búfer necesario para contener el nombre descriptivo del dispositivo, incluido el carácter de finalización.

[in, out] pcchDeviceManufacturer

En la entrada, el número máximo de caracteres que pDeviceManufacturer puede contener, no incluido el carácter de terminación. En la salida, el número de caracteres devueltos por pDeviceManufacturer, no incluye el carácter de terminación.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto Descripción
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)
 El búfer proporcionado no es lo suficientemente grande como para contener la descripción del dispositivo. (Consulte el valor devuelto en pcchDeviceDescription para el tamaño necesario).
HRESULT_FROM_WIN32(ERROR_INVALID_DATA)
 No se encontró la descripción del dispositivo.
S_OK
 El método se ha llevado a cabo de forma correcta.
E_POINTER
 Al menos uno de los argumentos necesarios era un puntero NULL .

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado portabledeviceapi.h
Library PortableDeviceGUIDs.lib

Consulte también

IPortableDeviceManager (interfaz)

IPortableDeviceManager::GetDevices