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

2023-08-25

Метод 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

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

Интерфейс IWMDMStorageGlobals

Использование защищенных каналов с проверкой подлинности

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