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

Artigo
03/13/2024

Recupera o nome do fabricante do dispositivo.

Sintaxe

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

Parâmetros

[in] pszPnPDeviceID

Ponteiro para uma cadeia de caracteres terminada em nulo que contém a ID de Plug and Play do dispositivo. Você pode recuperar uma lista de nomes de Plug and Play de todos os dispositivos conectados ao computador chamando GetDevices.

[in, out] pDeviceManufacturer

Um buffer alocado pelo chamador que contém o nome do fabricante do dispositivo. Para saber o tamanho necessário para esse parâmetro, primeiro chame esse método com esse parâmetro definido como NULL e pcchDeviceManufacturer definido como 0; o método terá êxito e definirá pcchDeviceManufacturer para o tamanho do buffer necessário para manter o nome amigável do dispositivo, incluindo o caractere de terminação.

[in, out] pcchDeviceManufacturer

Na entrada, o número máximo de caracteres que pDeviceManufacturer pode conter, sem incluir o caractere de terminação. Na saída, o número de caracteres retornados por pDeviceManufacturer, não incluindo o caractere de terminação.

Retornar valor

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno	Descrição
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)	O buffer fornecido não é grande o suficiente para manter a descrição do dispositivo. (Consulte o valor retornado em pcchDeviceDescription para o tamanho necessário.)
HRESULT_FROM_WIN32(ERROR_INVALID_DATA)	Não foi possível encontrar a descrição do dispositivo.
S_OK	O método foi bem-sucedido.
E_POINTER	Pelo menos um dos argumentos necessários era um ponteiro NULL .

Requisitos

Requisito	Valor
Plataforma de Destino	Windows
Cabeçalho	portabledeviceapi.h
Biblioteca	PortableDeviceGUIDs.lib

Confira também

IPortableDeviceManager Interface

IPortableDeviceManager::GetDevices

Compartilhar via