Share via

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

  • Artículo

El método GetSerialNumber recupera un número de serie que identifica de forma única el medio de almacenamiento. Este método se debe implementar para la transferencia de contenido protegido, pero de lo contrario es opcional. Para obtener más información, consulte Interfaces obligatorias y opcionales.

.

Sintaxis

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

Parámetros

[out] pSerialNum

Puntero a una estructura WMDMID que contiene la información del número de serie. Este parámetro se incluye en el código de autenticación del mensaje de salida.

[in, out] abMac

Matriz de ocho bytes que contiene el código de autenticación de mensajes para los datos de parámetros de este método. (WMDM_MAC_LENGTH se define como 8).

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. El código de retorno siempre debe comprobarse para determinar si el medio de almacenamiento proporciona esta compatibilidad. Si el medio de almacenamiento no admite la devolución de un número de serie único, el contenido protegido no se puede transferir al medio. Si el almacenamiento representado es un medio extraíble, el número de serie devuelto debe ser el número de serie de almacenamiento, que debe ser distinto del número de serie del dispositivo.

Requisitos

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

Consulte también

Interfaz IMDSPStorageGlobals

WMDMID