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

  • Artículo

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

Sintaxis

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

Parámetros

[out] pSerialNumber

Puntero a una estructura WMDMID que recibe el número de serie del dispositivo. 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 dispositivos multimedia admiten números de serie. Para determinar si el dispositivo admite números de serie, compruebe siempre el código devuelto al llamar a este método. Si un dispositivo multimedia admite números de serie, se garantiza que el número de serie del dispositivo multimedia es único.

Este método es opcional. Al transferir contenido protegido, Windows Media Administrador de dispositivos usa IMDSPStorageGlobals::GetSerialNumber. Para obtener más información, consulte Interfaces obligatorias y opcionales.

Requisitos

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

Consulte también

Interfaz IMDSPDevice

IMDSPStorageGlobals::GetSerialNumber