IGPMAsyncProgress interface (gpmgmt.h)

The IGPMAsyncProgress interface can be implemented by the client and passed as an input parameter to the Group Policy Management Console (GPMC) methods that can execute asynchronously. The server will then notify the client about the progress of the operation. Methods include IGPMGPO::GenerateReport, IGPMBackup::GenerateReport, IGPMRSOP::GenerateReport, RestoreGPO, Backup, Import, and CopyTo. This object cannot be accessed through scripting. For more information, see the "Remarks" section.

Inheritance

The IGPMAsyncProgress interface inherits from the IDispatch interface. IGPMAsyncProgress also has these types of members:

Methods

The IGPMAsyncProgress interface has these methods.

 
IGPMAsyncProgress::Status

The server calls this method to notify the client about the status of a Group Policy Management Console (GPMC) operation.

Remarks

Complex GPMC operations, such as backup, restore, import, and copy operations, can execute asynchronously. To use this interface with asynchronous operations, follow these steps.

To use this interface with asynchronous operations

  1. Implement the IGPMAsyncProgress interface.
  2. Pass the IGPMAsyncProgress interface pointer to the GPMC method. For example, pass the interface pointer to the RestoreGPO method or to the Import method.
The server will call the Status method to notify the client about the progress of the operation. This method also returns an IGPMAsyncCancel interface pointer so that the caller can cancel the operation by calling the Cancel method.

Requirements

Requirement Value
Minimum supported client Windows Vista
Minimum supported server Windows Server 2008
Target Platform Windows
Header gpmgmt.h

See also

IDispatch

IGPMAsyncCancel