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 錯誤碼
- 轉換成 HRESULT 值的 Windows 錯誤碼
- Windows Media 裝置管理員 錯誤碼
備註
並非所有儲存媒體都支援序號，但需要序號才能支援 Microsoft 數位版權管理。 如果儲存媒體無法報告唯一的序號，則受 Microsoft 數位版權管理保護的內容無法傳輸至此儲存媒體。 應該檢查傳回碼，以判斷儲存媒體是否提供此支援。
範例
下列 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 |
| 標頭 | mswmdm.h |
| 程式庫 | Mssachlp.lib |