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

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

Syntax

HRESULT GetAppInfo(
  [out] PAPPINFODATA pai
);

Parameters

[out] pai

Тип: APPINFODATA*

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

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

Тип: HRESULT

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

Замечания

Реализация должна проверить cbSize, сравнивая ее с размером APPINFODATA. Если cbSize не равен размеру APPINFODATA, этот метод должен вернуть значение ошибки COM, например E_FAIL.

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

Examples

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

Требования

См. также

• APPINFODATA
• IAppPublisher
• IPublishedApp::GetPublishedAppInfo
• IShellApp