IMDSPStorageGlobals::GetSerialNumber-Methode (mswmdm.h)
Die GetSerialNumber-Methode ruft eine Seriennummer ab, die das Speichermedium eindeutig identifiziert. Diese Methode muss für die Übertragung geschützter Inhalte implementiert werden, ist aber andernfalls optional. Weitere Informationen finden Sie unter Obligatorische und optionale Schnittstellen.
.
Syntax
HRESULT GetSerialNumber(
[out] PWMDMID pSerialNum,
[in, out] BYTE [8] abMac
);
Parameter
[out] pSerialNum
Zeiger auf eine WMDMID-Struktur , die die Seriennummerninformationen enthält. Dieser Parameter ist im Authentifizierungscode der Ausgabenachricht enthalten.
[in, out] abMac
Array von acht Bytes, das den Nachrichtenauthentifizierungscode für die Parameterdaten dieser Methode enthält. (WMDM_MAC_LENGTH ist als 8 definiert.)
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:
- Standard-COM-Fehlercodes
- In HRESULT-Werte konvertierte Windows-Fehlercodes
- Windows Media Geräte-Manager Fehlercodes
Hinweise
Nicht alle Speichermedien unterstützen Seriennummern. Der Rückgabecode muss immer überprüft werden, um zu bestimmen, ob das Speichermedium diese Unterstützung bereitstellt. Wenn das Speichermedium die Rückgabe einer eindeutigen Seriennummer nicht unterstützt, können geschützte Inhalte nicht auf das Medium übertragen werden. Wenn es sich bei dem dargestellten Speicher um Wechselmedien handelt, muss die zurückgegebene Seriennummer die Seriennummer des Speichers sein, die sich von der Seriennummer des Geräts unterscheiden sollte.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | mswmdm.h |
| Bibliothek | Mssachlp.lib |