IWMDMStorageGlobals::GetSerialNumber-Methode (mswmdm.h)
Die GetSerialNumber-Methode ruft eine Seriennummer ab, die das Speichermedium eindeutig identifiziert.
Syntax
HRESULT GetSerialNumber(
[out] PWMDMID pSerialNum,
[in, out] BYTE [8] abMac
);
Parameter
[out] pSerialNum
Zeiger auf eine WMDMID-Struktur , die die Seriennummerninformationen angibt.
[in, out] abMac
Array von Bytes, das den Nachrichtenauthentifizierungscode für die Parameterdaten dieser Methode angibt. Dieser Arbeitsspeicher wird vom Aufrufer zugewiesen und freigegeben.
Rückgabewert
Die Methode gibt ein HRESULT zurück. Alle Schnittstellenmethoden in Windows Media Geräte-Manager können eine der folgenden Klassen von Fehlercodes zurückgeben:
- Com-Standardfehlercodes
- In HRESULT-Werte konvertierte Windows-Fehlercodes
- Windows Media Geräte-Manager Fehlercodes
Hinweise
Nicht alle Speichermedien unterstützen Seriennummern, aber eine Seriennummer ist erforderlich, um die Verwaltung digitaler Rechte von Microsoft zu unterstützen. Wenn das Speichermedium keine eindeutige Seriennummer melden kann, können inhalte, die durch die Verwaltung digitaler Rechte von Microsoft geschützt sind, nicht auf dieses Speichermedium übertragen werden. Der Rückgabecode sollte überprüft werden, um zu ermitteln, ob das Speichermedium diese Unterstützung bereitstellt.
Beispiele
Der folgende C++-Code ruft die Seriennummer des Stammspeicherobjekts ab und überprüft den 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;
}
}
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | mswmdm.h |
| Bibliothek | Mssachlp.lib |