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

Метод IMDSPDevice::GetSerialNumber (mswmdm.h)

  • Статья

Метод GetSerialNumber извлекает серийный номер, который однозначно идентифицирует устройство.

Синтаксис

HRESULT GetSerialNumber(
  [out]     PWMDMID  pSerialNumber,
  [in, out] BYTE [8] abMac
);

Параметры

[out] pSerialNumber

Указатель на структуру WMDMID , которая получает серийный номер устройства. Этот параметр включен в код проверки подлинности выходного сообщения.

[in, out] abMac

Массив из восьми байтов, содержащий код проверки подлинности сообщения для данных параметров этого метода. (WMDM_MAC_LENGTH определяется как 8.)

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

Метод возвращает HRESULT. Все методы интерфейса в Windows Media диспетчер устройств могут возвращать любой из следующих классов кодов ошибок:

  • Стандартные коды ошибок COM
  • Коды ошибок Windows, преобразованные в значения HRESULT
  • Коды ошибок диспетчер устройств Windows Media
Подробный список возможных кодов ошибок см. в разделе Коды ошибок.

Комментарии

Не все устройства мультимедиа поддерживают серийные номера. Чтобы определить, поддерживает ли устройство серийные номера, всегда проверка код возврата при вызове этого метода. Если устройство мультимедиа поддерживает серийные номера, серийный номер устройства мультимедиа гарантированно будет уникальным.

Этот метод является необязательным. При передаче защищенного содержимого Windows Media диспетчер устройств использует IMDSPStorageGlobals::GetSerialNumber. Дополнительные сведения см. в разделе Обязательные и необязательные интерфейсы.

Требования

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

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

Интерфейс IMDSPDevice

IMDSPStorageGlobals::GetSerialNumber