ISCPSecureQuery::Metode ExamineData (mswmdm.h)

Metode ExamineData menentukan hak dan tanggung jawab atas konten dengan memeriksa data yang diteruskan Windows Media Device Manager ke metode ini.

Sintaks

HRESULT ExamineData(
  [in]      UINT     fuFlags,
  [in]      LPWSTR   pwszExtension,
  [in]      BYTE     *pData,
  [in]      DWORD    dwSize,
  [in, out] BYTE [8] abMac
);

Parameter

[in] fuFlags

Bendera yang menjelaskan data yang ditawarkan kepada penyedia konten aman untuk membuat keputusan. Bendera berikut dapat ada.

Bendera	Deskripsi
WMDM_SCP_EXAMINE_DATA	Parameter pData menunjuk ke data yang akan diperiksa.

[in] pwszExtension

Arahkan ke ekstensi nama file untuk diperiksa jika penyedia konten aman meminta ekstensi dalam panggilan GetDataDemands .

[in] pData

Arahkan ke data di awal file yang akan diperiksa. Parameter ini harus disertakan dalam kode autentikasi pesan input dan harus dienkripsi.

[in] dwSize

DWORD yang berisi panjang, dalam byte, dari data yang akan diperiksa. Parameter ini harus disertakan dalam kode autentikasi pesan input.

[in, out] abMac

Array delapan byte yang berisi kode autentikasi pesan untuk data parameter metode ini. (WMDM_MAC_LENGTH didefinisikan sebagai 8.)

Mengembalikan nilai

Metode mengembalikan HRESULT. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil. Penyedia isi aman bertanggung jawab atas isi ini.
WMDM_E_CALL_OUT_OF_SEQUENCE	Metode ini dipanggil dari urutan. GetDataDemands harus dipanggil terlebih dahulu.
WMDM_E_MAC_CHECK_FAILED	Kode autentikasi pesan tidak valid.
WMDM_E_MOREDATA	Pengelola Perangkat Windows Media harus memanggil metode ini lagi dengan paket data lain. Ukuran paket ditentukan oleh parameter pdwMinExamineData dalam metode GetDataDemands .
S_FALSE	Penyedia isi aman tidak bertanggung jawab atas isi ini. Hentikan interaksi dengan penyedia konten aman.
E_INVALIDARG	Parameter tidak valid atau merupakan penunjuk NULL .
E_FAIL	Terjadi kesalahan yang tidak ditentukan.

Keterangan

Metode ini dipanggil setelah metode GetDataDemands . Penyedia konten aman menggunakan informasi yang diteruskan dalam metode ini untuk menentukan apakah ia bertanggung jawab atas konten. Parameter fuFlags dikonsultasikan untuk menentukan data mana yang telah disajikan untuk pemeriksaan. Parameter pData menunjuk ke awal data hak dan tanggung jawab. Parameter dwSize berisi panjang, dalam byte, dari data hak dan tanggung jawab.

Jika bendera WMDM_SCP_EXAMINE_DATA diatur, parameter pDataBuffer berisi dwDataLength byte untuk diperiksa penyedia konten aman.

Jika metode ini tidak mengembalikan S_OK atau WMDM_E_MOREDATA, maka Windows Media Device Manager tidak melakukan panggilan lebih lanjut ke penyedia konten aman ini.

Persyaratan

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

Lihat juga

Antarmuka ISCPSecureQuery