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

Статья
02/29/2024

Метод GetSerialNumber извлекает серийный номер, однозначно определяющий среду хранения. Этот метод должен быть реализован для передачи защищенного содержимого, но в противном случае он необязателен. Дополнительные сведения см. в разделе Обязательные и необязательные интерфейсы.

Синтаксис

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

Параметры

[out] pSerialNum

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

[in, out] abMac

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

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

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

Стандартные коды ошибок COM
Коды ошибок Windows, преобразованные в значения HRESULT
Коды ошибок диспетчер устройств Windows Media

Подробный список возможных кодов ошибок см. в разделе Коды ошибок.

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

Требования

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

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

Интерфейс IMDSPStorageGlobals

WMDMID

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