Compartilhar via

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

  • Artigo

O método GetSerialNumber recupera o número de série que identifica exclusivamente o dispositivo.

Sintaxe

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

Parâmetros

[out] pSerialNumber

Ponteiro para uma estrutura WMDMID que recebe o número de série do dispositivo. Esse parâmetro está incluído no código de autenticação de mensagem de saída.

[in, out] abMac

Matriz de oito bytes que contém o código de autenticação de mensagem para os dados de parâmetro desse método. (WMDM_MAC_LENGTH é definido como 8.)

Retornar valor

O método retorna um HRESULT. Todos os métodos de interface no Windows Media Gerenciador de Dispositivos podem retornar qualquer uma das seguintes classes de códigos de erro:

  • Códigos de erro COM padrão
  • Códigos de erro do Windows convertidos em valores HRESULT
  • Códigos de erro do Windows Media Gerenciador de Dispositivos
Para obter uma lista abrangente de possíveis códigos de erro, consulte Códigos de erro.

Comentários

Nem todos os dispositivos de mídia dão suporte a números de série. Para determinar se o dispositivo dá suporte a números de série, sempre marcar o código de retorno ao chamar esse método. Se um dispositivo de mídia der suporte a números de série, o número de série do dispositivo de mídia será garantido como exclusivo.

Esse método é opcional. Ao transferir conteúdo protegido, o Windows Media Gerenciador de Dispositivos usa IMDSPStorageGlobals::GetSerialNumber. Para obter mais informações, consulte Interfaces obrigatórias e opcionais.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho mswmdm.h
Biblioteca Mssachlp.lib

Confira também

IMDSPDevice Interface

IMDSPStorageGlobals::GetSerialNumber