Metodo IMDSPDevice::GetName (mswmdm.h)

Articolo
02/29/2024

Il metodo GetName recupera il nome del dispositivo.

Sintassi

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

Parametri

[out] pwszName

Puntatore a una matrice di caratteri Unicode a 16 bit che riceve la stringa del nome del dispositivo.

[in] nMaxChars

Numero massimo di caratteri da copiare nella stringa.

Valore restituito

Il metodo restituisce un HRESULT. Tutti i metodi di interfaccia in Windows Media Gestione dispositivi possono restituire una delle classi di codici di errore seguenti:

Codici di errore COM standard
Codici di errore di Windows convertiti in valori HRESULT
Codici di errore di Windows Media Gestione dispositivi

Per un elenco completo dei codici di errore possibili, vedere Codici di errore.

Commenti

Il tipo di stringa LPWSTR è una stringa di caratteri Unicode a 16 bit e non accetta caratteri di byte. Per convertire una stringa di caratteri di byte (LPCSTR) in una stringa LPWSTR, usare la funzione MultiByteToWideChar, come descritto nella documentazione di Microsoft Windows.

I nomi dei dispositivi non devono contenere spazi finali.

Questo metodo deve essere implementato. Non deve restituire WMDM_E_NOTSUPPORTED o E_NOTIMPL. Per altre informazioni, vedere Interfacce obbligatorie e facoltative.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	mswmdm.h
Libreria	Mssachlp.lib

Vedi anche

Interfaccia IMDSPDevice

IMDSPDevice::GetType

Condividi tramite