Метод IWMDMStorageGlobals::GetSerialNumber (mswmdm.h)
Метод GetSerialNumber извлекает серийный номер, который однозначно идентифицирует среду хранения.
Синтаксис
HRESULT GetSerialNumber(
[out] PWMDMID pSerialNum,
[in, out] BYTE [8] abMac
);
Параметры
[out] pSerialNum
Указатель на структуру WMDMID , указывающую сведения о серийном номере.
[in, out] abMac
Массив байтов, указывающий код проверки подлинности сообщения для данных параметров этого метода. Эта память выделяется и освобождается вызывающим объектом.
Возвращаемое значение
Метод возвращает HRESULT. Все методы интерфейса в Windows Media диспетчер устройств могут возвращать любой из следующих классов кодов ошибок:
- Стандартные коды ошибок COM
- Коды ошибок Windows, преобразованные в значения HRESULT
- Коды ошибок диспетчер устройств Windows Media
Комментарии
Не все носители поддерживают серийные номера, но для поддержки управления цифровыми правами Майкрософт требуется серийный номер. Если носитель хранилища не может сообщить уникальный серийный номер, содержимое, защищенное службой управления цифровыми правами Майкрософт, не может быть передано на этот носитель. Код возврата должен быть проверен, чтобы определить, обеспечивает ли эту поддержку носитель хранилища.
Примеры
Следующий код C++ извлекает серийный номер корневого объекта хранилища и проверяет MAC-адрес.
hr = m_pStorageGlobals->GetSerialNumber(&m_SerialNumber, (BYTE*)abMAC);
if (SUCCEEDED(hr))
{
// Verify the MAC using the CSecureChannelClient member.
m_pSAC->MACInit(&hMAC);
m_pSAC->MACUpdate(hMAC, (BYTE*)(&m_SerialNumber), sizeof(m_SerialNumber));
m_pSAC->MACFinal(hMAC, (BYTE*)abMACVerify);
if (memcmp(abMACVerify, abMAC, sizeof(abMAC)) != 0)
{
hr = E_FAIL;
}
}
Требования
Требование | Значение |
---|---|
Целевая платформа | Windows |
Header | mswmdm.h |
Библиотека | Mssachlp.lib |
См. также раздел
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по