|
|
/*
* WUV3CTL.h - definitions/declarations for Windows Update V3 Catalog infra-structure * * Copyright (c) 1998-1999 Microsoft Corporation. All Rights Reserved. * * Purpose: * This file defines the structures, values, macros, and functions * used by the Version 3 Windows Update Catalog Control * */
#ifndef _WUV3CTL_INC
#pragma pack(1)
//GetCatalog lFilters
#define USEWUV3INCLUDES
#include <wuv3.h>
#undef USEWUV3INCLUDES
//filter values for GetCatalog
#define WU_ALL_ITEMS (long)0x00000000 //all items (no hidden items)
#define WU_UPDATE_ITEMS (long)0x10000000 //items that are not currently installed
#define WU_NO_DEVICE_DRIVERS (long)0x00000200 //do not return drivers (can be used with WU_ALL_ITEMS)
#define WU_PERSONALIZE_HIDDEN (long)0x00000800 //items hidden by user (can be used with WU_ALL_ITEMS)
#define WU_HIDDEN_ITEMS (long)0x00000001 //only items marked as hidden.
#define WU_SELECTED_ITEMS (long)0x00000002 //selected items.
#define WU_NOT_SELECTED_ITEMS (long)0x00000004 //items that are not currently selected.
#define WU_NEW_ITEMS (long)0x00000008 //items that are marked as new
#define WU_POWER_ITEMS (long)0x00000010 //items that are marked as power user items
#define WU_REGISTER_ITEMS (long)0x00000020 //items that are marked as needing registration
#define WU_COOL_ITEMS (long)0x00000040 //items that are marked as cool
#define WU_EUAL_ITEMS (long)0x00000080 //items that are marked as having a End user
#define WU_PATCH_ITEMS (long)0x00000100 //items that are marked as a patch.
//used for ProcessCatalog
#define WU_NO_PRUNING (long)0x00000400 //This flag is mainly used for corporate catalog as well as internal
//debugging and testing, it will cause the pruning logic to not be
//applied to the retrieved catalog.
//GetCatalog array status values
#define GETCATALOG_STATUS_HIDDEN (long)0x00000001 //Catalog item hidden.
#define GETCATALOG_STATUS_SELECTED (long)0x00000002 //Catalog item selected for installation.
#define GETCATALOG_STATUS_NEW (long)0x00000004 //Catalog item is a new offering.
#define GETCATALOG_STATUS_POWER (long)0x00000008 //Catalog item is best for power users.
#define GETCATALOG_STATUS_REGISTRATION (long)0x00000010 //Catalog item requires that the client be registered.
#define GETCATALOG_STATUS_COOL (long)0x00000020 //Catalog item is considered an interesting item.
#define GETCATALOG_STATUS_PATCH (long)0x00000040 //Catalog item is a patch so requires special handling.
#define GETCATALOG_STATUS_SECTION (long)0x00000080 //Catalog item is a section header.
#define GETCATALOG_STATUS_SUBSECTION (long)0x00000100 //Catalog item is a sub section header.
#define GETCATALOG_STATUS_SUBSUBSECTION (long)0x00000200 //Catalog item is a sub sub section header.
#define GETCATALOG_STATUS_INSTALL (long)0x00000400 //Catalog item is an install for an item that the client current does not have.
#define GETCATALOG_STATUS_UPDATE (long)0x00000800 //Catalog item is an update for an item that currently exists on the client computer.
#define GETCATALOG_STATUS_CURRENT (long)0x00001000 //Catalog item is currently installed on the client system.
#define GETCATALOG_STATUS_UNKNOWN (long)0x00002000 //Catalog item's status could not be determined.
#define GETCATALOG_STATUS_CRITICALUPDATE (long)0x00004000 //Catalog item is marked as a critical update item.
#define GETCATALOG_STATUS_EXCLUSIVE (long)0x00008000 //Catalog item is exclusive it cannot be selected with other components.
#define GETCATALOG_STATUS_PERSONALIZE_HIDDEN (long)0x00010000 //Catalog item hidden by registry
#define GETCATALOG_STATUS_WARNING_SCARY (long)0x00020000 //Display a scary warning message
//ChangeItemState possible states
#define ITEM_STATE_HIDE_ITEM (long)0x00000001 //Hide Catalog item
#define ITEM_STATE_SHOW_ITEM (long)0x00000002 //Show Catalog item
#define ITEM_STATE_SELECT_ITEM (long)0x00000004 //Select Catalog item
#define ITEM_STATE_UNSELECT_ITEM (long)0x00000008 //Unselect Catalog item
#define ITEM_STATE_PERSONALIZE_HIDE (long)0x00000010 //Hide item using registry hiding
#define ITEM_STATE_INSTALL_ITEM (long)0x00000020 //The item is to be selected for installation.
#define ITEM_STATE_REMOVE_ITEM (long)0x00000040 //The item is to be selected for removal.
#define ITEM_STATE_PERSONALIZE_UNHIDE (long)0x00000080 //Unhide item from registry hiding
//InstallSelectedItems flags
#define WU_NO_SPECIAL_FLAGS (long)0x00000000 //This flag is only valid if used by itself. It is used
#define WU_COPYONLY_NO_INSTALL (long)0x00000001 //This flag is used to indicate that the selected packages
//should be copied to the client machine but not installed.
//The OPERATION_SUCCESS and OPERATION_FAILED equate to
//ITEM_STATUS_SUCCESS and ITEM_STATUS_INSTALLED_ERROR which
//are defined in cstate.h
#define OPERATION_SUCCESS (long)0x0000000 //Log entry operation was successfull.
#define OPERATION_ERROR (long)0x0000001 //Log entry operation had one or more errors.
#define OPERATION_STARTED (long)0x0000002 //Log entry operation was started
#define INSTALL_OPERATION (long)0x0001000 //Log entry is for an Install Operation.
#define REMOVE_OPERATION (long)0x0002000 //Log entry is for an Remove Operation.
//flags for FinalizeInstall
#define FINALIZE_DOREBOOT 0x00000001
#define FINALIZE_NOREBOOTPROMPT 0x00000002
//Install Remove Item History structure.
typedef struct _HISTORYSTRUCT { PUID puid; //item's puid.
char szTitle[256]; //items title.
BOOL bInstall; //TRUE if installed, FALSE if removed
DWORD bResult; //OPERATION_SUCCESS, OPERATION_ERROR, OPERATION_STARTED
HRESULT hrError; //specific error code if an error occured.
char szVersion[40]; //formated version or driverver
char szDate[32]; char szTime[32]; BYTE RecType; //record type: driver or activesetup
BOOL bV2; //imported from V2
} HISTORYSTRUCT, *PHISTORYSTRUCT;
//Each catalog item is returned in a structure of this type.
typedef struct _CATALOG32ITEM { PUID puid; //Items puid identifier.
PTCHAR pTitle; //localized title display text.
PTCHAR pDescription; //localized description text.
long lStatus; //status of this item.
int iDownloadSize; //download size in bytes.
int iDownloadTime; //download time in minutes.
PSTR pUninstallKey; //uninstall string
} CATALOG32ITEM, *PCATALOG32ITEM;
//Structures used with the C++ Interfaces
typedef struct _CATALOG32 { int iTotalItems; //Total items in catalog
PCATALOG32ITEM pItems; //Array of catalog item structures.
} CATALOG32, *PCATALOG32;
//Install Results item structure
typedef struct _INSTALLRESULTSTATUS { PUID puid; //The identifier for this record.
int iStatus; //This field is one of the following:
//ITEM_STATUS_SUCCESS The package was installed successfully.
//ITEM_STATUS_INSTALLED_ERROR The package was Installed however there were some minor problems that did not prevent installation.
//ITEM_STATUS_FAILED The packages was not installed.
HRESULT hrError; //Error describing the reason that the package did not install if the Status field is not equal to SUCCESS.
} INSTALLRESULTSTATUS, *PINSTALLRESULTSTATUS;
//Install results array returned from GetInstallStatus32().
typedef struct _INSTALLRESULTSARRAY { int iTotalItems; //Total items returned in array.
PINSTALLRESULTSTATUS pItems; //Specific install status items.
} INSTALLRESULTSARRAY, *PINSTALLRESULTSARRAY;
//Install Metrics item structure
typedef struct _INSTALLMETRICSITEMS { PUID puid; //The identifier for this record.
int iDownloadSize; //download size in bytes.
int iDownloadTime; //download time in minutes.
} INSTALLMETRICSITEMS, *PINSTALLMETRICSITEMS;
//Install results array returned from GetInstallStatus32().
typedef struct _INSTALLMETRICSARRAY { int iTotalItems; //Total items returned in array.
PINSTALLMETRICSITEMS pItems; //Specific install status items.
} INSTALLMETRICSARRAY, *PINSTALLMETRICSARRAY;
//Returned install and remove history structure array. This array
//is returned from the GetInstallHistory32() method.
typedef struct _HISTORYARRAY { int iTotalItems; //Total returned items.
#pragma warning( disable : 4200 )
HISTORYSTRUCT HistoryItems[]; //Array of history items.
#pragma warning( default : 4200 )
} HISTORYARRAY, *PHISTORYARRAY;
//
// IWUpdateCatalog interface
//
class __declspec(novtable) IWUpdateCatalog : public IUnknown { public: STDMETHOD(WUIsCatalogAvailable)(long puidCatalog, BSTR bstrServerUrl) = 0; STDMETHOD(WUGetCatalog)(long puidCatalog, BSTR bstrServerUrl, long platformId, BSTR bstrBrowserLangauge, CCatalog** ppCatalogArray) = 0; STDMETHOD(WUDownloadItems)(CSelections* pSelections, BSTR bstrServer, BSTR bstrTempDir) = 0; STDMETHOD(WUInstallItems)(CSelections* pSelections, BSTR bstrServer, BSTR bstrTempDir) = 0; STDMETHOD(WURemoveItems)(CSelections* pSelections) = 0; STDMETHOD(WUCopyInstallHistory)(HISTORYARRAY** ppHistoryArray) = 0; STDMETHOD(WUCopyDependencyList)(long puidItem, long** ppDepPuid) = 0; STDMETHOD(WUProgressDlg)(BOOL bOn) = 0; };
class __declspec(uuid("1B1FA90D-96CD-11d2-9E16-00C04F79E980")) IWUpdateCatalog;
#include <autoupd.h>
#pragma pack()
#define _WUV3CTL_INC
#endif
|
