IPublishedApp

コントロールパネルの「プログラムの追加と削除」にアプリケーションを表示するためのメソッドを公開します。

コントロールパネルの「プログラムの追加と削除」にアプリケーションを公開するには、IEnumPublishedApps、IAppPublisher、および IPublishedApp をサポートする必要があります。

アプリケーション発行元によって公開されたアプリケーションをインストールします。このメソッドは、コントロールパネルの「プログラムの追加と削除」でユーザーが「追加」または「後で追加」を選択したときに呼び出されます。

型: HRESULT

このメソッドが成功すると S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

アプリケーション発行元によって公開されたアプリケーションに関する発行関連情報を取得します。

型: HRESULT

このメソッドが成功すると S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

PUBAPPINFO 構造体の dwMask メンバーは、どのメンバーが要求されたかを示します。「プログラムの追加と削除」は PAI_SCHEDULEDTIME および PAI_EXPIREDTIME ビットを設定しないことに注意してください。ただし、対応する値 stScheduled および stExpired は、実装がそれらを提供する場合に該当する状況で使用されます。発行元は、これらのデータが利用可能であれば提供する必要があります。

例

次の例は実装のサンプルを示します。

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


                    

アプリケーション発行元によって公開されたアプリケーションのインストールをキャンセルします。

型: HRESULT

このメソッドが成功すると S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

このメソッドは、次の各状況で呼び出されます。

1. コントロールパネルの「プログラムの追加と削除」の「後で追加」ダイアログボックスで、ユーザーが「プログラムを追加しない」オプションを選択した場合。
2. 公開されたアプリケーション情報で指定された有効期限または割り当て時刻のいずれよりも後のインストール時刻を、ユーザーが選択した場合。これらの状況では、実装はそのアプリケーションに対してスケジュールされたインストールをすべてキャンセルすることが期待されます。