Метод IShellApp::GetAppInfo (shappmgr.h)

Статья
03/05/2024

Возвращает общие сведения о приложении.

Синтаксис

HRESULT GetAppInfo(
  [out] PAPPINFODATA pai
);

Параметры

[out] pai

Тип: APPINFODATA*

Указатель на структуру APPINFODATA , которая возвращает сведения о приложении.

Возвращаемое значение

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Добавление и удаление программ в панель управления задаст элемент dwMask структуры APPINFODATA, чтобы указать, что необходимо вернуть AIM_DISPLAYNAME и AIM_SUPPORTURL. Для каждого значения, возвращаемого в APPINFODATA, необходимо задать соответствующий бит в dwMask. Все остальные биты должны быть очищены.

Примеры

Ниже приведен пример использования битов 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);

}

Требования

Требование	Значение
Минимальная версия клиента	Windows XP, Windows 2000 Профессиональная [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	shappmgr.h
DLL	Shell32.dll