IShellApp::GetAppInfo-Methode (shappmgr.h)

Ruft allgemeine Informationen zu einer Anwendung ab.

Syntax

HRESULT GetAppInfo(
  [out] PAPPINFODATA pai
);

Parameter

[out] pai

Typ: APPINFODATA*

Ein Zeiger auf eine APPINFODATA-Struktur , die die Anwendungsinformationen zurückgibt.

Rückgabewert

Typ: HRESULT-

Wenn diese Methode erfolgreich ist, wird S_OKzurückgegeben. Andernfalls wird ein HRESULT- Fehlercode zurückgegeben.

Bemerkungen

Ihre Implementierung sollte cbSize überprüfen, indem sie mit der Größe von APPINFODATA verglichen wird. Wenn cbSize nicht der Größe von APPINFODATA entspricht, sollte diese Methode einen COM-Fehlerwert wie E_FAIL zurückgeben.

"Programme hinzufügen/entfernen" im Systemsteuerung legt das dwMask-Element der APPINFODATAstruktur fest, um anzugeben, dass Sie AIM_DISPLAYNAME und AIM_SUPPORTURL zurückgeben sollten. Für jeden Wert, den Sie in APPINFODATA zurückgeben, müssen Sie das entsprechende Bit in dwMask festlegen. Alle anderen Bits sollten gelöscht werden.

Beispiele

Hier ist ein Beispiel für die Verwendung der dwMask-Bits:

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);
}

Requirements

Siehe auch

• APPINFODATA
• IAppPublisher
• IPublishedApp::GetPublishedAppInfo
• IShellApp