Metodo IWMDMStorageGlobals::GetSerialNumber (mswmdm.h)

Articolo
03/05/2024

Il metodo GetSerialNumber recupera un numero di serie che identifica in modo univoco il supporto di archiviazione.

Sintassi

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

Parametri

[out] pSerialNum

Puntatore a una struttura WMDMID che specifica le informazioni sul numero di serie.

[in, out] abMac

Matrice di byte che specifica il codice di autenticazione del messaggio per i dati dei parametri di questo metodo. Questa memoria viene allocata e liberata dal chiamante.

Valore restituito

Il metodo restituisce un HRESULT. Tutti i metodi di interfaccia in Windows Media Gestione dispositivi possono restituire una delle classi di codici di errore seguenti:

Codici di errore COM standard
Codici di errore di Windows convertiti in valori HRESULT
Codici di errore di Windows Media Gestione dispositivi

Per un elenco completo dei codici di errore possibili, vedere Codici di errore.

Commenti

Non tutti i numeri di serie del supporto multimediale di archiviazione, ma è necessario un numero di serie per supportare la gestione dei diritti digitali Microsoft. Se il supporto di archiviazione non può segnalare un numero di serie univoco, il contenuto protetto da Microsoft digital rights management non può essere trasferito a questo supporto di archiviazione. Il codice restituito deve essere controllato per determinare se il supporto di archiviazione fornisce questo supporto.

Esempio

Il codice C++ seguente recupera il numero di serie dell'oggetto di archiviazione radice e verifica il 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;
        }
    }

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	mswmdm.h
Libreria	Mssachlp.lib

Vedi anche

Interfaccia IWMDMStorageGlobals

Uso di canali autenticati sicuri

Condividi tramite