共用方式為


UIEventCls Class

Applies To: System Center Configuration Manager 2007, System Center Configuration Manager 2007 R2, System Center Configuration Manager 2007 R3, System Center Configuration Manager 2007 SP1, System Center Configuration Manager 2007 SP2

Important

This class and its corresponding methods, in Configuration Manager, might be deprecated in the future.

Important

When you are using this class, the client user interface will no longer be functional. These methods are blocking calls and if they are not implemented correctly; they can cause issues with client functionality.

The client raises various notifications in response to a request made to run a program through the Configuration Manager SDK, Run Advertised Programs, or Add or Remove Programs. These notifications are raised through the COM+ Event System. The purpose of these notifications is to inform users about the current state of their request. The client user experience for software distribution and software update is implemented by using these notifications.

Developers can replace the existing client user interface elements with their own user interface elements by implementing these notifications. This can be achieved by implementing the IUIEvent interface and exposing it through a DCOM local server. A third-party DCOM local server can be registered with the COM+ Event System to subscribe to these notifications.

Methods

Name Description

IUIEventCls::ClearNewAppAvailable Method

Called when Add or Remove Programs is opened by a user.

This method might be deprecated in the future.

IUIEventCls::ClearNewScriptAvailable Method

Called when Run Advertised Programs is opened by a user.

This method might be deprecated in the future.

IUIEventCls::ClearSoftwareUpdate Method

Called when no more software updates are available to install on a client computer.

This method is no longer used in Configuration Manager.

IUIEventCls::ContentStatus Method

Called in response to a request from CheckContentAvailability.

This method might be deprecated in the future.

IUIEventCls::DownloadComplete Method

Called when the client finishes downloading the content of a program locally.

This method might be deprecated in the future.

IUIEventCls::DownloadFailed Method

Called when the client fails to download the content of a program locally.

This method might be deprecated in the future.

IUIEventCls::DownloadProgress Method

Provides information about the current progress of a requested content download.

This method might be deprecated in the future.

IUIEventCls::DownloadStarted Method

Called when the client starts downloading the content of a program locally.

This method might be deprecated in the future.

IUIEventCls::ExecutionFailed Method

Called if the program that is started by the client returns a failure.

This method might be deprecated in the future.

IUIEventCls::LogoffRequired Method

Called when the client runs a program that requires a user to log off after the successful completion of the program.

This method might be deprecated in the future.

IUIEventCls::NewAppAvailable Method

Called when a Configuration Manager administrator advertises an optional program that should become available in Add or Remove Programs.

This method might be deprecated in the future.

IUIEventCls::NewScriptAvailable Method

Called when a Configuration Manager administrator advertises an optional program that should become available in Run Advertised Programs.

This method might be deprecated in the future.

IUIEventCls::ReadyAssignedProgram Method

Called when a mandatory program is ready to run.

This method might be deprecated in the future.

IUIEventCls::ReadyUserProgram Method

Called when an optional program requires download and the program is ready to run after completing the download.

This method might be deprecated in the future.

IUIEventCls::RebootRequired Method

Called when the client runs a program that requires a restart after the successful completion of a program.

This method is no longer used in Configuration Manager.

IUIEventCls::RunInstallProgram Method

Called when a user selects an optional program to run from Add/Remove Programsor Run Advertised Programs.

This method might be deprecated in the future.

IUIEventCls::ShowMessage Method

Never called.

This method might be deprecated in the future.

IUIEventCls::ShowProgramDownloadMonitor Method

Called when a user activates the program download monitor from Control Panel.

This method might be deprecated in the future.

IUIEventCls::SoftwareUpdateAvailable Method

Called when there are pending software updates that need to be installed on a client computer.

This method is no longer used in Configuration Manager.

IUIEventCls::SoftwareUpdateProgress Method

Called in response to a user's request to install pending software updates.

This method is no longer used in Configuration Manager.

IUIEventCls::UserInitialize Method

Called each time a user logs on to a computer.

This method might be deprecated in the future.

UIEventCls Structures and Enumerations

Structures and enumerations that are used by UIEventCls.

Requirements

UIEvent.dll.

Runtime Requirements

For more information, see Configuration Manager Client Runtime Requirements.

Development Requirements

For more information, see Configuration Manager Client Development Requirements.

See Also

Concepts

Software Distribution Client Control Panel Automation