Condividi tramite


Metodo IMDSPDevice2::GetCanonicalName (mswmdm.h)

Il metodo GetCanonicalPName ottiene il nome canonico di un dispositivo.

Sintassi

HRESULT GetCanonicalName(
  [out] LPWSTR pwszPnPName,
  [in]  UINT   nMaxChars
);

Parametri

[out] pwszPnPName

Un buffer wide con terminazione Null che contiene il nome canonico. Il chiamante alloca e rilascia questo buffer.

[in] nMaxChars

Intero contenente il numero massimo di caratteri che possono essere inseriti in pwszCanonicalName, incluso il carattere di terminazione.

Valore restituito

Il metodo restituisce un valore HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Commenti

Questo metodo restituisce un nome canonico per il dispositivo. Il provider di servizi deve restituire il nome del percorso del dispositivo come nome canonico. Al provider di servizi viene passato il nome del percorso del dispositivo nel metodo CreateDevice nell'interfaccia IMDServiceProvider2 .

Operazione facoltativa. Per altre informazioni, vedere Interfacce obbligatorie e facoltative.

Requisiti

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

Vedi anche

Interfaccia IMDSPDevice2

Interfaccia IMDServiceProvider2

IMDServiceProvider2::CreateDevice