Metodo IShellApp::GetAppInfo (shappmgr.h)

Ottiene informazioni generali su un'applicazione.

Sintassi

HRESULT GetAppInfo(
  [out] PAPPINFODATA pai
);

Parametri

[out] pai

Tipo: APPINFODATA*

Puntatore a una struttura APPINFODATA che restituisce le informazioni sull'applicazione.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

L'implementazione deve convalidare cbSize confrontandola con le dimensioni di APPINFODATA. Se cbSize non è uguale alla dimensione di APPINFODATA, questo metodo deve restituire un valore di errore COM come E_FAIL.

Aggiungi/Rimuovi programmi nella Pannello di controllo imposta il membro dwMask della struttura APPINFODATA per indicare che è necessario restituire AIM_DISPLAYNAME e AIM_SUPPORTURL. Per ogni valore restituito in APPINFODATA, è necessario impostare il bit corrispondente in dwMask. Tutti gli altri bit devono essere cancellati.

Esempio

Ecco un esempio di come usare i 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);

}

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP, Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shappmgr.h
DLL	Shell32.dll

Vedi anche

APPINFODATA

IAppPublisher

IPublishedApp::GetPublishedAppInfo

IShellApp