Fungsi MsiEnumComponentsExA (msi.h)

Fungsi MsiEnumComponentsEx menghitung komponen yang diinstal. Fungsi ini mengambil kode komponen untuk satu komponen setiap kali dipanggil. Kode komponen adalah STRING GUID yang unik untuk komponen, versi, dan bahasa.

Windows Installer 4.5 atau yang lebih lama: Tidak didukung. Fungsi ini tersedia dimulai dengan Windows Installer 5.0.

Sintaksis

UINT MsiEnumComponentsExA(
  [in, optional]  LPCSTR            szUserSid,
  [in]            DWORD             dwContext,
  [in]            DWORD             dwIndex,
  [out, optional] CHAR [39]         szInstalledComponentCode,
  [out, optional] MSIINSTALLCONTEXT *pdwInstalledContext,
  [out, optional] LPSTR             szSid,
  [in, out]       LPDWORD           pcchSid
);

Parameter

[in, optional] szUserSid

String null-terminated yang berisi pengidentifikasi keamanan (SID.) Enumerasi komponen yang diinstal meluas ke pengguna yang diidentifikasi oleh SID ini. String SID khusus s-1-1-0 (Semua Orang) menentukan enumerasi semua komponen yang diinstal di semua produk semua pengguna dalam sistem. Nilai SID selain s-1-1-0 menentukan SID pengguna untuk pengguna tertentu dan membatasi enumerasi ke instans aplikasi yang diinstal oleh pengguna yang ditentukan.

[in] dwContext

Bendera yang membatasi enumerasi komponen yang diinstal ke instans produk yang diinstal dalam konteks penginstalan yang ditentukan. Enumerasi hanya mencakup instans produk yang diinstal oleh pengguna yang ditentukan oleh szUserSid.

[in] dwIndex

Menentukan indeks komponen yang akan diambil. Parameter ini harus nol (0) untuk panggilan pertama ke fungsi MsiEnumComponentsEx. Untuk setiap panggilan berikutnya, indeks harus bertambah 1. Indeks hanya boleh dinaikkan jika panggilan sebelumnya ke fungsi mengembalikan ERROR_SUCCESS. Komponen tidak diurutkan dan dapat dikembalikan oleh fungsi dalam urutan apa pun.

[out, optional] szInstalledComponentCode

Buffer output yang menerima GUID kode komponen untuk komponen yang diinstal. Panjang buffer harus cukup besar untuk menahan nilai string null-terminated yang berisi kode komponen. 38 karakter TCHAR pertama menerima GUID untuk komponen, dan karakter ke-39 menerima karakter NULL yang mengakhiri.

[out, optional] pdwInstalledContext

Bendera yang memberikan konteks penginstalan aplikasi yang menginstal komponen.

[out, optional] szSid

Menerima pengidentifikasi keamanan (SID) yang mengidentifikasi pengguna yang menginstal aplikasi yang memiliki komponen. Lokasi menerima string kosong jika instans aplikasi ini diinstal dalam konteks penginstalan per komputer.

Panjang buffer di lokasi ini harus cukup besar untuk menahan nilai string yang dihentikan null yang berisi SID. Jika buffer terlalu kecil, fungsi mengembalikan ERROR_MORE_DATA dan lokasi yang ditunjukkan oleh pcchSid menerima jumlah TCHAR di SID, tidak termasuk karakter NULL yang mengakhiri.

Jika szSid diatur ke NULL dan pcchSid adalah penunjuk yang valid ke lokasi dalam memori, fungsi mengembalikan ERROR_SUCCESS dan lokasi menerima jumlah TCHAR dalam SID, tidak termasuk karakter null yang mengakhiri. Fungsi kemudian dapat dipanggil lagi untuk mengambil nilai , dengan szSid buffer mengubah ukuran yang cukup besar untuk berisi *pcchSid + 1 karakter.

[in, out] pcchSid

Menerima jumlah TCHAR dalam SID, tidak termasuk karakter null yang mengakhiri. Ketika fungsi kembali, variabel ini diatur ke ukuran SID yang diminta apakah fungsi dapat berhasil menyalin SID dan mengakhiri karakter null ke lokasi buffer yang ditujukan oleh szSid. Ukuran dikembalikan sebagai jumlah TCHAR dalam nilai yang diminta, tidak termasuk karakter null yang mengakhiri.

Parameter ini dapat diatur ke NULL hanya jika szSid juga NULL, jika tidak, fungsi mengembalikan ERROR_INVALID_PARAMETER. Jika szSid dan pcchSid keduanya diatur ke NULL, fungsi mengembalikan ERROR_SUCCESS jika SID ada, tanpa mengambil nilai SID.

Mengembalikan nilai

Fungsi MsiEnumProductsEx mengembalikan salah satu nilai berikut.

Komentar

Persyaratan