Compartilhar via

Método IMDSPDevice::GetName (mswmdm.h)

  • Artigo

O método GetName recupera o nome do dispositivo.

Sintaxe

HRESULT GetName(
  [out] LPWSTR pwszName,
  [in]  UINT   nMaxChars
);

Parâmetros

[out] pwszName

Ponteiro para uma matriz de caracteres Unicode de 16 bits que recebe a cadeia de caracteres de nome do dispositivo.

[in] nMaxChars

Número máximo de caracteres a serem copiados para a cadeia de caracteres.

Retornar valor

O método retorna um HRESULT. Todos os métodos de interface no Windows Media Gerenciador de Dispositivos podem retornar qualquer uma das seguintes classes de códigos de erro:

  • Códigos de erro COM padrão
  • Códigos de erro do Windows convertidos em valores HRESULT
  • Códigos de erro do Windows Media Gerenciador de Dispositivos
Para obter uma lista abrangente de possíveis códigos de erro, consulte Códigos de erro.

Comentários

O tipo de cadeia de caracteres LPWSTR é uma cadeia de caracteres Unicode de 16 bits e não aceita caracteres do tamanho de bytes. Para converter uma cadeia de caracteres de tamanho de byte (LPCSTR) em uma cadeia de caracteres LPWSTR , use a função MultiByteToWideChar , conforme descrito na documentação do Microsoft Windows.

Os nomes de dispositivo não devem conter espaços à direita.

Esse método deve ser implementado. Ele não deve retornar WMDM_E_NOTSUPPORTED ou E_NOTIMPL. Para obter mais informações, consulte Interfaces obrigatórias e opcionais.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho mswmdm.h
Biblioteca Mssachlp.lib

Confira também

IMDSPDevice Interface

IMDSPDevice::GetType