Share via

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

  • Artículo

El método GetSerialNumber recupera un número de serie que identifica de forma única el medio de almacenamiento.

Sintaxis

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

Parámetros

[out] pSerialNum

Puntero a una estructura WMDMID que especifica la información del número de serie.

[in, out] abMac

Matriz de bytes que especifican el código de autenticación de mensajes para los datos de parámetros de este método. El autor de la llamada asigna y libera esta memoria.

Valor devuelto

El método devuelve un valor HRESULT. Todos los métodos de interfaz de Windows Media Administrador de dispositivos pueden devolver cualquiera de las siguientes clases de códigos de error:

  • Códigos de error COM estándar
  • Códigos de error de Windows convertidos en valores HRESULT
  • Códigos de error de windows Media Administrador de dispositivos
Para obtener una lista extensa de posibles códigos de error, consulte Códigos de error.

Comentarios

No todos los medios de almacenamiento admiten números de serie, pero se requiere un número de serie para admitir la administración de derechos digitales de Microsoft. Si el medio de almacenamiento no puede notificar un número de serie único, el contenido protegido por Microsoft Digital Rights Management no se puede transferir a este medio de almacenamiento. El código de retorno debe comprobarse para determinar si el medio de almacenamiento proporciona esta compatibilidad.

Ejemplos

El siguiente código de C++ recupera el número de serie del objeto de almacenamiento raíz y comprueba el 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;
        }
    }

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado mswmdm.h
Library Mssachlp.lib

Consulte también

IWMDMStorageGlobals (Interfaz)

Uso de canales autenticados seguros