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
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 |