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

Weitere Informationen

IMDSPStorageGlobals-Schnittstelle

WMDMID