Compartilhar via

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

  • Artigo

O método GetSerialNumber recupera um número de série que identifica exclusivamente o meio de armazenamento. Esse método deve ser implementado para transferência de conteúdo protegido, mas, caso contrário, é opcional. Para obter mais informações, consulte Interfaces obrigatórias e opcionais.

.

Sintaxe

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

Parâmetros

[out] pSerialNum

Ponteiro para uma estrutura WMDMID que contém as informações de número de série. 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 todas as mídias de armazenamento dão suporte a números de série. O código de retorno sempre deve ser verificado para determinar se o meio de armazenamento fornece esse suporte. Se a mídia de armazenamento não der suporte ao retorno de um número de série exclusivo, o conteúdo protegido não poderá ser transferido para o meio. Se o armazenamento representado for uma mídia removível, o número de série retornado deverá ser o número de série de armazenamento, que deve ser diferente do número de série do dispositivo.

Requisitos

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

Confira também

IMDSPStorageGlobals Interface

WMDMID