IShellApp::Metode GetAppInfo (shappmgr.h)

Artikel
03/04/2024

Mendapatkan informasi umum tentang aplikasi.

Sintaks

HRESULT GetAppInfo(
  [out] PAPPINFODATA pai
);

Parameter

[out] pai

Jenis: APPINFODATA*

Penunjuk ke struktur APPINFODATA yang mengembalikan informasi aplikasi.

Mengembalikan nilai

Jenis: HRESULT

Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Catatan Tambahkan/Hapus Program di Panel Kontrol mengatur anggota cbSize dan dwMask dari struktur APPINFODATA.

Implementasi Anda harus memvalidasi cbSize dengan membandingkannya dengan ukuran APPINFODATA. Jika cbSize tidak sama dengan ukuran APPINFODATA, metode ini harus mengembalikan nilai kesalahan COM seperti E_FAIL.

Tambahkan/Hapus Program dalam Panel Kontrol akan mengatur anggota dwMask dari struktur APPINFODATA untuk menunjukkan bahwa Anda harus mengembalikan AIM_DISPLAYNAME dan AIM_SUPPORTURL. Untuk setiap nilai yang Anda kembalikan di APPINFODATA, Anda harus mengatur bit yang sesuai di dwMask. Semua bit lainnya harus dibersihkan.

Contoh

Berikut adalah sampel cara menggunakan bit dwMask::

HRESULT CPubApp::GetAppInfo(APPINFODATA *pData)
{
    if (sizeof(APPINFODATA) != pData->cbSize)
        return E_FAIL;

    // First save off the mask of requested data items.

    const DWORD dwMask = pData->dwMask;

    // Zero-out the mask.  Bits will be set as items are obtained. 

    pData->dwMask = 0;

    // Call an internal function that obtains data and sets
    // bits in pData->dwMask for each item obtained.

    return get_app_info_data(pData, dwMask);

}

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP, Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	shappmgr.h
DLL	Shell32.dll