Compartilhar via

Método IMDSPDevice2::GetCanonicalName (mswmdm.h)

  • Artigo

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

Confira também

IMDSPDevice2 Interface

IMDServiceProvider2 Interface

IMDServiceProvider2::CreateDevice