IWMDMDevice：：GetSerialNumber 方法 (mswmdm.h)

  • 项目

GetSerialNumber 方法检索唯一标识设备的序列号。

语法

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

参数

[out] pSerialNumber

指向 WMDMID 结构的指针，该结构指定序列号信息。 WMDID 结构由应用程序分配和释放。

[in, out] abMac

字节数组，指定此方法的参数数据的消息身份验证代码。

返回值

该方法返回 HRESULT。 Windows Media 设备管理器 中的所有接口方法都可以返回以下任一类错误代码：

  • 标准 COM 错误代码
  • 转换为 HRESULT 值的 Windows 错误代码
  • Windows Media 设备管理器错误代码
有关可能错误代码的广泛列表，请参阅 错误代码。

注解

并非所有设备都支持序列号。 若要确定设备是否支持序列号，调用方在调用此函数时必须始终检查返回代码。 如果媒体设备支持序列号，则保证媒体设备的序列号对于该设备是唯一的。

调用此方法后，应用程序可以使用 abMAC 参数验证在传输过程中是否未修改串行。 有关此代码的示例代码，请参阅 使用经过身份验证的安全通道。

示例

以下 C++ 代码检索设备序列号并验证 MAC。


//
// Get and verify the serial number.
//
WMDMID serialNumber;
BYTE receivedMAC[WMDM_MAC_LENGTH];
hr = pIWMDMDevice->GetSerialNumber(&serialNumber, receivedMAC);

// Check the MAC to guarantee the serial number has not been tampered with.
if (hr == S_OK)
{
    // Initialize a MAC handle, 
    // next add all parameters to the MAC,
    // and finally retrieve the calculated MAC value.
    HMAC hMAC;
    BYTE calculatedMAC[WMDM_MAC_LENGTH];
    hr = m_pSAC->MACInit(&hMAC);
    hr = m_pSAC->MACUpdate(hMAC, (BYTE*)(&serialNumber), sizeof(serialNumber));
    hr = m_pSAC->MACFinal(hMAC, (BYTE*)calculatedMAC);
    if (memcmp(calculatedMAC, receivedMAC, sizeof(calculatedMAC)) == 0)
    {
        // MAC is authentic. Print the serial number.
        CHAR* serialNumberBuffer = new CHAR[serialNumber.SerialNumberLength + 1];
        ZeroMemory(serialNumberBuffer, (serialNumber.SerialNumberLength + 1) * sizeof(CHAR));
        memcpy(serialNumberBuffer, serialNumber.pID, serialNumber.SerialNumberLength * sizeof(CHAR));
        // TODO: Display the serial number.
        delete serialNumberBuffer;
    }
    else
        // TODO: Display a message indicating that the serial number MAC does not match in EnumDevices
}

要求

要求 值
目标平台 Windows
标头 mswmdm.h
Library Mssachlp.lib

另请参阅

IWMDMDevice 接口

使用经过安全身份验证的通道