ISnapinAbout Interface

The ISnapinAbout interface enables the console to get copyright and version information from a snap-in. The console also uses this interface to obtain images for the static folder from the snap-in.

When To Implement

All snap-ins should implement this interface to provide the information that is typically found in an About property page. Default static folder images and icons are used for display if the ISnapinAbout interface is not implemented.

For efficiency, the ISnapinAbout interface is usually implemented by a separate object. The class ID of this object must be provided as a value under the snap-in's MMC registry key. See SnapIns Key for details. MMC will call CoCreateInstance to create an instance of the object when it is required.

MMC attempts to create About objects on a background thread to avoid blocking the UI thread. Snap-in authors are encouraged to design their About object to use an apartment or free threading model to support this.

When To Use

This interface is used by MMC's Snap-in Manager.

Methods

The ISnapinAbout interface inherits the methods of the IUnknown interface.

In addition, ISnapinAbout defines the following methods.

MethodDescription

GetSnapinDescription

Obtains snap-in description box text.

GetProvider

Obtains the name of the snap-in provider.

GetSnapinVersion

Obtains the version number of the snap-in.

GetSnapinImage

Obtains the main icon for the About box.

GetStaticFolderImage

Obtains static folder images for both the scope and result panes.

 

Requirements

Minimum supported clientWindows 2000 Professional
Minimum supported serverWindows 2000 Server
HeaderMmc.h

Send comments about this topic to Microsoft

Build date: 5/27/2009

Tags :


Page view tracker