IWMDMStorageGlobals::Metode GetSerialNumber (mswmdm.h)

Artikel
02/29/2024

Metode GetSerialNumber mengambil nomor seri yang secara unik mengidentifikasi media penyimpanan.

Sintaks

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

Parameter

[out] pSerialNum

Penunjuk ke struktur WMDMID yang menentukan informasi nomor seri.

[in, out] abMac

Array byte yang menentukan kode autentikasi pesan untuk data parameter metode ini. Memori ini dialokasikan dan dibebaskan oleh pemanggil.

Nilai kembali

Metode mengembalikan HRESULT. Semua metode antarmuka di Windows Media Device Manager dapat mengembalikan salah satu kelas kode kesalahan berikut:

Kode kesalahan COM standar
Kode kesalahan Windows dikonversi ke nilai HRESULT
Kode kesalahan Pengelola Perangkat Windows Media

Untuk daftar ekstensif kemungkinan kode kesalahan, lihat Kode Kesalahan.

Keterangan

Tidak semua nomor seri dukungan media penyimpanan, tetapi nomor seri diperlukan untuk mendukung manajemen hak digital Microsoft. Jika media penyimpanan tidak dapat melaporkan nomor seri unik, konten yang dilindungi oleh manajemen hak digital Microsoft tidak dapat ditransfer ke media penyimpanan ini. Kode pengembalian harus diperiksa untuk menentukan apakah media penyimpanan menyediakan dukungan ini.

Contoh

Kode C++ berikut mengambil nomor seri objek penyimpanan akar, dan memverifikasi 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;
        }
    }

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	mswmdm.h
Pustaka	Mssachlp.lib

Lihat juga

Antarmuka IWMDMStorageGlobals

Menggunakan Saluran Terautentikasi Aman

Bagikan melalui