IPublishedApp::GetPublishedAppInfo-Methode (shappmgr.h)

Artikel
03/01/2024

Ruft Veröffentlichungsbezogene Informationen zu einer Anwendung ab, die von einem Anwendungsherausgeber veröffentlicht wird.

Syntax

HRESULT GetPublishedAppInfo(
  [out] PPUBAPPINFO ppai
);

Parameter

[out] ppai

Typ: PUBAPPINFO*

Ein Zeiger auf eine PUBAPPINFO-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

Das dwMask-Element der PUBAPPINFO-Struktur gibt an, welche Member angefordert wurden. Beachten Sie, dass die PAI_SCHEDULEDTIME und PAI_EXPIREDTIME Bits durch Hinzufügen/Entfernen nicht festgelegt werden. Die entsprechenden Werte stScheduled und stExpired werden jedoch ggf. verwendet, wenn die Implementierung sie bereitstellt. Ein Herausgeber sollte diese Daten bereitstellen, sofern sie verfügbar sind.

Beispiele

Das Beispiel zeigt eine Beispielimplementierung:

HRESULT CPubApp::GetPublishedAppInfo(PUBAPPINFO *pInfo)
{
    if (sizeof(PUBAPPINFO) != pInfo->cbSize)
        return E_FAIL;
		
    // Add/Remove Programs will use these items but will not ask for them.

    pInfo->dwMask |= (PAI_EXPIRETIME | PAI_SCHEDULEDTIME);

    // First save off the mask of requested data items.

    const DWORD dwMask = pInfo->dwMask;

    // Zero-out the mask.  The bits should be set as items are retrieved.

    pInfo->dwMask = 0;

    // Call an internal function that obtains data and sets
    // bits in pInfo->dwMask for each item obtained.

    return get_pub_app_info(pInfo, 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

Weitere Informationen