Méthode IWMDMStorageGlobals ::GetSerialNumber (mswmdm.h)

La méthode GetSerialNumber récupère un numéro de série qui identifie de manière unique le support de stockage.

Syntaxe

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

Paramètres

[out] pSerialNum

Pointeur vers une structure WMDMID spécifiant les informations de numéro de série.

[in, out] abMac

Tableau d’octets spécifiant le code d’authentification de message pour les données de paramètre de cette méthode. Cette mémoire est allouée et libérée par l’appelant.

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, mais un numéro de série est requis pour prendre en charge la gestion des droits numériques Microsoft. Si le support de stockage ne peut pas signaler un numéro de série unique, le contenu protégé par Microsoft Digital Rights Management ne peut pas être transféré vers ce support de stockage. Le code de retour doit être vérifié pour déterminer si le support de stockage fournit cette prise en charge.

Exemples

Le code C++ suivant récupère le numéro de série de l’objet de stockage racine et vérifie le MAC.

    hr = m_pStorageGlobals->GetSerialNumber(&m_SerialNumber, (BYTE*)abMAC);
    if (SUCCEEDED(hr))
    {
        // Verify the MAC using the CSecureChannelClient member.
        m_pSAC->MACInit(&hMAC);
        m_pSAC->MACUpdate(hMAC, (BYTE*)(&m_SerialNumber), sizeof(m_SerialNumber));
        m_pSAC->MACFinal(hMAC, (BYTE*)abMACVerify);
        if (memcmp(abMACVerify, abMAC, sizeof(abMAC)) != 0)
        {
            hr = E_FAIL;
        }
    }

Configuration requise

Voir aussi

IWMDMStorageGlobals Interface

Utilisation de canaux authentifiés sécurisés