IMDSPDevice::GetSerialNumber-Methode (mswmdm.h)

Die GetSerialNumber-Methode ruft die Seriennummer ab, die das Gerät eindeutig identifiziert.

Syntax

HRESULT GetSerialNumber(
  [out]     PWMDMID  pSerialNumber,
  [in, out] BYTE [8] abMac
);

Parameter

[out] pSerialNumber

Zeiger auf eine WMDMID-Struktur , die die Seriennummer für das Gerät empfängt. 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
Eine umfassende Liste möglicher Fehlercodes finden Sie unter Fehlercodes.

Hinweise

Nicht alle Mediengeräte unterstützen Seriennummern. Um festzustellen, ob das Gerät Seriennummern unterstützt, überprüfen Sie beim Aufrufen dieser Methode immer den Rückgabecode. Wenn ein Mediengerät Seriennummern unterstützt, ist die Seriennummer des Mediengeräts garantiert eindeutig.

Diese Methode ist optional. Beim Übertragen geschützter Inhalte verwendet Windows Media Geräte-Manager IMDSPStorageGlobals::GetSerialNumber. Weitere Informationen finden Sie unter Obligatorische und optionale Schnittstellen.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile mswmdm.h
Bibliothek Mssachlp.lib

Weitere Informationen

IMDSPDevice-Schnittstelle

IMDSPStorageGlobals::GetSerialNumber