Поделиться через


Метод IMDSPDevice2::GetCanonicalName (mswmdm.h)

Метод GetCanonicalPName получает каноническое имя устройства.

Синтаксис

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

Параметры

[out] pwszPnPName

Расширенный символ, заканчивающийся нулевым значением буфер, содержащий каноническое имя. Вызывающий объект выделяет и освобождает этот буфер.

[in] nMaxChars

Целое число, содержащее максимальное количество символов, которые можно поместить в pwszCanonicalName, включая символ завершения.

Возвращаемое значение

Метод возвращает HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.

Комментарии

Этот метод возвращает каноническое имя устройства. Поставщик услуг должен вернуть путь к устройству в качестве канонического имени. Поставщик услуг передает имя пути устройства в методе CreateDevice в интерфейсе IMDServiceProvider2 .

Водить описание не обязательно. Дополнительные сведения см. в разделе Обязательные и необязательные интерфейсы.

Требования

Требование Значение
Целевая платформа Windows
Header mswmdm.h
Библиотека Mssachlp.lib

См. также раздел

Интерфейс IMDSPDevice2

Интерфейс IMDServiceProvider2

IMDServiceProvider2::CreateDevice