Método IMDSPDevice2::GetCanonicalName (mswmdm.h)
O método GetCanonicalPName obtém o nome canônico de um dispositivo.
Sintaxe
HRESULT GetCanonicalName(
[out] LPWSTR pwszPnPName,
[in] UINT nMaxChars
);
Parâmetros
[out] pwszPnPName
Um caractere largo, buffer terminado em nulo que contém o nome canônico. O chamador aloca e libera esse buffer.
[in] nMaxChars
Inteiro que contém o número máximo de caracteres que podem ser colocados em pwszCanonicalName, incluindo o caractere de encerramento.
Retornar valor
O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.
Comentários
Esse método retorna um nome canônico para o dispositivo. O provedor de serviços deve retornar o nome do caminho do dispositivo como seu nome canônico. O provedor de serviços recebe o nome do caminho do dispositivo no método CreateDevice na interface IMDServiceProvider2 .
Isso é opcional. 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 |