Compartilhar via

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

  • Artigo

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

Sintaxe

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

Parâmetros

[out] pSerialNum

Ponteiro para uma estrutura WMDMID especificando as informações de número de série.

[in, out] abMac

Matriz de bytes especificando o código de autenticação de mensagem para os dados de parâmetro desse método. Essa memória é alocada e liberada pelo chamador.

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 de Gerenciador de Dispositivos do Windows Media
Para obter uma ampla lista 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, mas um número de série é necessário para dar suporte ao gerenciamento de direitos digitais da Microsoft. Se o meio de armazenamento não puder relatar um número de série exclusivo, o conteúdo protegido pelo gerenciamento de direitos digitais da Microsoft não poderá ser transferido para esse meio de armazenamento. O código de retorno deve ser verificado para determinar se o meio de armazenamento fornece esse suporte.

Exemplos

O código C++ a seguir recupera o número de série do objeto de armazenamento raiz e verifica o 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 Valor
Plataforma de Destino Windows
Cabeçalho mswmdm.h
Biblioteca Mssachlp.lib

Confira também

IWMDMStorageGlobals Interface

Usando canais autenticados seguros