MÉTHODE IMDSPStorageGlobals ::GetSerialNumber (mswmdm.h)
La méthode GetSerialNumber récupère un numéro de série identifiant de manière unique le support de stockage. Cette méthode doit être implémentée pour le transfert de contenu protégé, mais dans le cas contraire, elle est facultative. Pour plus d’informations, consultez Interfaces obligatoires et facultatives.
.
Syntaxe
HRESULT GetSerialNumber(
[out] PWMDMID pSerialNum,
[in, out] BYTE [8] abMac
);
Paramètres
[out] pSerialNum
Pointeur vers une structure WMDMID contenant les informations de numéro de série. Ce paramètre est inclus dans le code d’authentification du message de sortie.
[in, out] abMac
Tableau de huit octets contenant le code d’authentification de message pour les données de paramètre de cette méthode. (WMDM_MAC_LENGTH est défini comme 8.)
Valeur retournée
Cette méthode retourne un code HRESULT. Toutes les méthodes d’interface dans Windows Media Gestionnaire de périphériques peuvent retourner l’une des classes de codes d’erreur suivantes :
- Codes d’erreur COM standard
- Codes d’erreur Windows convertis en valeurs HRESULT
- Codes d’erreur Gestionnaire de périphériques Windows Media
Remarques
Tous les supports de stockage ne prennent pas en charge les numéros de série. Le code de retour doit toujours être vérifié pour déterminer si le support de stockage fournit cette prise en charge. Si le support de stockage ne prend pas en charge le renvoi d’un numéro de série unique, le contenu protégé ne peut pas être transféré vers le support. Si le stockage représenté est un support amovible, le numéro de série retourné doit être le numéro de série de stockage, qui doit être distinct du numéro de série de l’appareil.
Configuration requise
Condition requise | Valeur |
---|---|
Plateforme cible | Windows |
En-tête | mswmdm.h |
Bibliothèque | Mssachlp.lib |