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

Eine ausführliche Liste möglicher Fehlercodes finden Sie unter 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

Weitere Informationen

IWMDMStorageGlobals-Schnittstelle

Verwenden von sicher authentifizierten Kanälen