Método IPublishedApp::GetPublishedAppInfo (shappmgr.h)

  • Artigo

Obtém informações relacionadas à publicação sobre um aplicativo publicado por um editor de aplicativos.

Sintaxe

HRESULT GetPublishedAppInfo(
  [out] PPUBAPPINFO ppai
);

Parâmetros

[out] ppai

Tipo: PUBAPPINFO*

Um ponteiro para uma estrutura PUBAPPINFO que retorna as informações do aplicativo.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

O membro dwMask da estrutura PUBAPPINFO indica quais membros foram solicitados. Observe que Adicionar/Remover Programas não definirá o PAI_SCHEDULEDTIME e PAI_EXPIREDTIME bits. No entanto, os valores correspondentes stScheduled e stExpired serão usados quando aplicável se a implementação os fornecer. Um editor deverá fornecer esses dados se eles estiverem disponíveis.

Exemplos

O exemplo mostra uma implementação de exemplo:

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

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP, Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shappmgr.h

Confira também

IAppPublisher

IEnumPublishedApps

IPublishedApp

PUBAPPINFO