Metode IUpdateSession3::QueryHistory (wuapi.h)

  • Artikel

Mengkueri komputer secara sinkron untuk riwayat peristiwa pembaruan. Metode ini mengembalikan penunjuk ke antarmuka IUpdateHistoryEntryCollection yang berisi rekaman peristiwa yang cocok di komputer.

Sintaks

HRESULT QueryHistory(
  [in]  BSTR                          criteria,
  [in]  LONG                          startIndex,
  [in]  LONG                          count,
  [out] IUpdateHistoryEntryCollection **retval
);

Parameter

[in] criteria

String yang menentukan kriteria pencarian.

[in] startIndex

Indeks peristiwa pertama yang diambil.

[in] count

Jumlah peristiwa yang akan diambil.

[out] retval

Penunjuk ke antarmuka IUpdateHistoryEntryCollection yang berisi rekaman peristiwa yang cocok di komputer dalam urutan kronologis menurun.

Mengembalikan nilai

Mengembalikan S_OK jika berhasil. Jika tidak, mengembalikan kode kesalahan COM atau Windows.

Metode ini juga dapat mengembalikan kode kesalahan berikut.

Menampilkan kode Deskripsi
E_POINTER
 Nilai parameter tidak valid atau NULL.
WU_E_INVALID_CRITERIA
 Ada kriteria pencarian yang tidak valid.

Keterangan

Kumpulan peristiwa yang dikembalikan diurutkan menurut tanggal dalam urutan menuram.

String yang digunakan untuk parameter kriteria harus cocok dengan bahasa pencarian kustom untuk QueryHistory. String berisi kriteria yang dievaluasi untuk menentukan peristiwa riwayat mana yang akan dikembalikan.

Perhatikan bahwa QueryHistory hanya mendukung pembaruan per komputer.

Untuk deskripsi lengkap sintaks kriteria pencarian, lihat Pencarian.

Tabel berikut mengidentifikasi semua kriteria dukungan publik, dalam urutan evaluasi yang diutamakan. Kriteria lainnya dapat ditambahkan ke daftar ini di masa mendatang.

Kriteria Jenis Operator yang diizinkan Deskripsi
UpdateID string(UUID) = Menemukan pembaruan yang memiliki UpdateIdentity.UpdateID dari nilai yang ditentukan.

Misalnya, "UpdateID='12345678-9abc-def0-1234-56789abcdef0'" menemukan pembaruan untuk UpdateIdentity.UpdateID yang sama dengan 12345678-9abc-def0-1234-56789abcdef0.

Persyaratan

   
Klien minimum yang didukung Windows XP, Windows 2000 Professional dengan SP3 [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003, Windows 2000 Server dengan SP3 [hanya aplikasi desktop]
Target Platform Windows
Header wuapi.h
Pustaka Wuguid.lib
DLL Wuapi.dll

Lihat juga

IUpdateSession3