Fungsi MsiEnumPatchesExW (msi.h)

Fungsi MsiEnumPatchesEx menghitung semua patch dalam konteks tertentu atau di semua konteks. Patch yang sudah diterapkan pada produk dijumlahkan. Patch yang telah terdaftar tetapi belum diterapkan pada produk juga dijumlahkan.

Sintaks

UINT MsiEnumPatchesExW(
  [in, optional]      LPCWSTR           szProductCode,
  [in, optional]      LPCWSTR           szUserSid,
  [in]                DWORD             dwContext,
  [in]                DWORD             dwFilter,
  [in]                DWORD             dwIndex,
  [out, optional]     WCHAR [39]        szPatchCode,
  [out, optional]     WCHAR [39]        szTargetProductCode,
  [out, optional]     MSIINSTALLCONTEXT *pdwTargetProductContext,
  [out, optional]     LPWSTR            szTargetUserSid,
  [in, out, optional] LPDWORD           pcchTargetUserSid
);

Parameter

[in, optional] szProductCode

String yang dihentikan null yang menentukan GUID ProductCode dari produk yang patchnya dijumlahkan. Jika non-NULL, enumerasi patch dibatasi untuk instans produk ini di bawah pengguna dan konteks yang ditentukan oleh szUserSid dan dwContext. Jika NULL, patch untuk semua produk dalam konteks yang ditentukan dijumlahkan.

[in, optional] szUserSid

String yang dihentikan null yang menentukan pengidentifikasi keamanan (SID) yang membatasi konteks enumerasi. String SID khusus "S-1-1-0" (Semua Orang) menentukan enumerasi di semua pengguna dalam sistem. Nilai SID selain "S-1-1-0" dianggap sebagai SID pengguna dan membatasi enumerasi untuk pengguna tersebut. Saat menghitung untuk pengguna selain pengguna saat ini, patch apa pun yang diterapkan dalam konteks per pengguna yang tidak dikelola menggunakan versi yang kurang dari Penginstal Windows versi 3.0, tidak dijumlahkan. Parameter ini dapat diatur ke NULL untuk menentukan pengguna saat ini.

[in] dwContext

Membatasi enumerasi ke satu atau kombinasi konteks. Parameter ini bisa berupa salah satu atau kombinasi dari nilai berikut.

[in] dwFilter

Filter untuk enumerasi. Parameter ini bisa berupa satu atau kombinasi parameter berikut.

[in] dwIndex

Indeks patch yang akan diambil. Parameter ini harus nol untuk panggilan pertama ke fungsi MsiEnumPatchesEx lalu dinaikkan untuk panggilan berikutnya. Parameter dwIndex harus dinaikkan hanya jika panggilan sebelumnya dikembalikan ERROR_SUCCESS.

[out, optional] szPatchCode

Buffer output untuk berisi GUID patch yang sedang dijumlahkan. Buffer harus cukup besar untuk menahan GUID. Parameter ini bisa NULL.

[out, optional] szTargetProductCode

Buffer output untuk berisi GUID ProductCode produk yang menerima patch ini. Buffer harus cukup besar untuk menahan GUID. Parameter ini bisa NULL.

[out, optional] pdwTargetProductContext

Mengembalikan konteks patch yang sedang dijumlahkan. Nilai output dapat MSIINSTALLCONTEXT_USERMANAGED, MSIINSTALLCONTEXT_USERUNMANAGED, atau MSIINSTALLCONTEXT_MACHINE. Parameter ini bisa NULL.

[out, optional] szTargetUserSid

Buffer output yang menerima string SID akun tempat instans patch ini berada. Buffer ini mengembalikan string kosong untuk konteks per komputer.

Buffer ini harus cukup besar untuk berisi SID. Jika buffer terlalu kecil, fungsi mengembalikan ERROR_MORE_DATA dan mengatur *pcchTargetUserSid ke jumlah TCHAR dalam nilai, tidak termasuk karakter NULL yang mengakhiri.

Jika szTargetUserSid diatur ke NULL dan pcchTargetUserSid diatur ke pointer yang valid, fungsi mengembalikan ERROR_SUCCESS dan mengatur *pcchTargetUserSid ke jumlah TCHAR dalam nilai, tidak termasuk karakter NULL yang mengakhiri. Fungsi kemudian dapat dipanggil lagi untuk mengambil nilai , dengan buffer szTargetUserSid cukup besar untuk berisi *pcchTargetUserSid + 1 karakter.

Jika szTargetUserSid dan pcchTargetUserSid keduanya diatur ke NULL, fungsi akan mengembalikan ERROR_SUCCESS jika nilainya ada, tanpa mengambil nilainya.

[in, out, optional] pcchTargetUserSid

Penunjuk ke variabel yang menentukan jumlah TCHAR dalam buffer szTargetUserSid . Ketika fungsi kembali, parameter ini diatur ke ukuran nilai yang diminta apakah fungsi menyalin nilai ke dalam buffer yang ditentukan atau tidak. Ukuran dikembalikan sebagai jumlah TCHAR dalam nilai yang diminta, tidak termasuk karakter null yang mengakhiri.

Parameter ini dapat diatur ke NULL hanya jika szTargetUserSid juga NULL, jika tidak, fungsi akan mengembalikan ERROR_INVALID_PARAMETER.

Mengembalikan nilai

Fungsi MsiEnumPatchesEx mengembalikan salah satu nilai berikut.

Keterangan

Non-administrator hanya dapat menghitung patch dalam visibilitasnya. Administrator dapat menghitung patch untuk konteks pengguna lain.

Persyaratan

Lihat juga

Konteks Penginstalan

MsiSourceListAddSourceEx

Tidak Didukung di Windows Installer 2.0 dan yang lebih lama

ProductCode