IShellApp::GetAppInfo-Methode (shappmgr.h)

  • Artikel

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_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Hinweis Software hinzufügen/entfernen im Systemsteuerung legt die elemente cbSize und dwMask der APPINFODATA-Struktur fest.
 
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 den dwMask-Member der APPINFODATA-Struktur so fest, 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

Im Folgenden finden Sie 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);

}

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP, Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shappmgr.h
DLL Shell32.dll

Weitere Informationen

APPINFODATA

IAppPublisher

IPublishedApp::GetPublishedAppInfo

IShellApp