AspNetMMCExt
Provides helper methods that are used by the ASP.NET snap-in for the Microsoft Management Console (MMC). This class cannot be inherited.
Initializes a new instance of the class.
Returns a comma separated list containing the version and path to the Aspnet_isapi.dll for each installed ASP.NET version.
A comma separated list containing the version and path to the Aspnet_isapi.dll for each installed ASP.NET version.
A 0 to display the ASP.NET version before the path for each entry; otherwise, display the path before the ASP.NET version for each entry.
Registers the version of Aspnet_isapi.dll that is specified by the parameter to the Microsoft Internet Information Services (IIS) virtual path that is specified by the parameter.
The virtual path to which to register the Aspnet_isapi.dll specified by the path passed in .
The path to the Aspnet_isapi.dll to register with .
The behavior to use when registering Aspnet_isapi.dll.
Retrieves the ASP.NET configuration settings for the specified ASP.NET Web application.
The computer to retrieve configuration settings from.
The ID of the IIS Web site to retrieve configuration settings from.
The IIS virtual directory to retrieve configuration settings from.
The name of the IIS site to retrieve configuration settings from.
The specific resource to which the configuration applies.
The system process ID of the process displaying the configuration settings dialog box.
The exception(s) that occurred.
Retrieves the window handle to the active window that is attached to the message queue of the calling thread.
The handle to the active window attached to the message queue of the calling thread; otherwise, null.
Returns a value indicating whether remote access to the ASP.NET configuration container is enabled.
A 1 if remote access to the ASP.NET configuration container is enabled; otherwise, 0.
Creates, displays, and operates a message box in the ASP.NET snap-in for the Microsoft Management Console (MMC).
IDCANCEL, if the message box has a Cancel button and either ESC is pressed or Cancel is clicked. If the message has no Cancel button, pressing ESC has no effect.
If the function fails, 0.
If the function succeeds, the return value is one of the following menu-item values:
Return value
Description
IDABORT
Abort was clicked.
IDCANCEL
Cancel was clicked.
IDCONTINUE
Continue was clicked.
IDIGNORE
Ignore was clicked.
IDNO
No was clicked.
IDOK
OK was clicked.
IDRETRY
Retry was clicked.
IDTRYAGAIN
Try Again was clicked.
IDYES
Yes was clicked.
A handle to the owner of the message box to create. If is null, the message box has no owner window.
The message for the message box to display.
The message box title.
The contents and behavior of the message box.
Returns a value indicating whether the passed parameter is a directory.
The path to the directory to check.
A 1, if is a directory; otherwise, 0.
Returns the creation, modified, and last access dates and times for the specified .
The name of the file from which to read the dates.
The date and time the file was created.
The date and time the file was modified.
The date and time the file was last accessed.
Registers the ASP.NET snap-in with the Microsoft Management Console (MMC).
A 1 to register or a 0 to unregister the type.
The name of the type to register
The directory containing the assembly.
A pointer to any exception thrown during registration.
Serves as a wrapper for a globally unique identifier (GUID) for a COM class.
Defines a new menu item, submenu, or insertion point for the method.
Processes messages that are sent to a modal or modeless dialog box.
true if the successfully processed the message; otherwise, false.
A handle to the dialog box.
The message.
Additional message-specific information.
Additional message-specific information.
A generalized Clipboard format containing a target device, the aspect or view of the data, and a storage medium indicator.
Provides helper methods that are used by the ASP.NET snap-in for the Microsoft Management Console (MMC).
Returns a comma separated list containing the version and path to the Aspnet_isapi.dll for each installed ASP.NET version.
A comma separated list containing the version and path to the Aspnet_isapi.dll for each installed ASP.NET version.
A 0 to display the ASP.NET version before the path for each entry; otherwise, display the path before the ASP.NET version for each entry.
Maps the specified Aspnet_isapi.dll to the specified Internet Information Services (IIS) virtual path.
The virtual path to which to register the Aspnet_isapi.dll specified by the path passed in .
The path to the Aspnet_isapi.dll to register with .
The behavior to use when registering Aspnet_isapi.dll.
Retrieves the ASP.NET configuration settings for the specified ASP.NET Web application.
The computer to retrieve configuration settings from.
The IIS Web site to retrieve configuration settings from.
The IIS virtual directory to retrieve configuration settings from.
The name of the IIS site to retrieve configuration settings from.
The specific resource to which the configuration applies.
The system process ID of the process displaying the configuration settings dialog box.
The exception(s) that occurred.
Returns a value indicating whether remote access to the ASP.NET configuration container is enabled.
A 1 if remote access to the ASP.NET configuration container is enabled; otherwise, 0.
Returns a value indicating whether the passed is a directory.
The path to the directory to check.
A 1 if is a directory; otherwise, 0.
Returns the creation, modified, and last access dates and times for the specified .
The name of the file from which to read the dates.
The date and time the file was created.
The date and time the file was modified.
The date and time the file was last accessed.
Registers the ASP.NET snap-in with the Microsoft Management Console (MMC).
A value of 1 to register or a value of 0 to unregister the assembly.
The name of the assembly to register.
The directory containing the assembly.
A pointer to any exception thrown during registration.
Adds menu items to a shortcut menu.
Adds a single item to a shortcut menu.
Return Value
Description
S_OK
was added successfully.
E_UNEXPECTED
An unexpected error occurred.
E_POINTER
is null.
E_INVALIDARG
One or more of the members contains one or more values that are not valid or the values cause a known error.
A pointer to a with the item to add.
Creates a connection between a caller and a data object implementing the interface. This connection enables notifications of changes to the caller in the data for the data object.
Creates a notification connection between a data object implementing the interface and a caller object, letting the caller receive notification of changes in the data for the data object.
The method supports the standard returns values E_INVALIDARG, E_UNEXPECTED, and E_OUTOFMEMORY, as well as the following return values:
Return value
Description
S_OK
The method successfully created the connection.
E_NOTIMPL
The data object does not implement the method.
DV_E_LINDEX
is not valid.
DV_E_FORMATETC
The data pointer value is not valid.
OLE_E_ADVISENOTSUPPORTED
The object does not support change notification.
A pointer to the defining the format, medium, and target device for notifications.
A value specifying the requested behavior for the connection.
A pointer to the on the caller object.
A pointer to the connection set up by this call to the method.
Destroys a notification connection that was created by an earlier call to the method.
Return value
Description
S_OK
The method successfully deleted the specified connection.
OLE_E_NOCONNECTION
The specified connection is not a valid connection.
OLE_E_ADVISENOTSUPPORTED
The object does not support change notification.
The connection to destroy.
Retrieves a pointer to an object that can enumerate the notification connections that are currently maintained by this interface.
The method supports the standard return value E_OUTOFMEMORY, as well as the following return values:
Return value
Description
S_OK
This call to the method successfully created the instance of the enumerator object.
-or-
There are no connections.
OLE_E_ADVISENOTSUPPORTED
The object does not support change notification.
The address of the receiving the interface pointer to the new enumerator object. There are no connections if this call to the method sets to null.
Retrieves a pointer to an object that can enumerate the enumerator types that this implementation supports.
The method supports the standard return values E_INVALIDARG and E_OUTOFMEMORY, as well as the following return values:
Return value
Description
S_OK
This call to the method successfully created the enumerator object.
E_NOTIMPL
The specified direction is not supported.
OLE_S_USEREG
A request to OLE to enumerate the formats from the registry.
A value from the indicating the direction of the data.
An output variable address receiving the .
Retrieves a pointer to a standard structure that is logically equivalent to, but not necessarily equal to, the structure that is referenced by the parameter.
The method supports the standard return values E_INVALIDARG, E_UNEXPECTED, and E_OUTOFMEMORY, as well as the following return values:
Return value
Description
S_OK
The returned FORMATETC is different from the structure passed in the parameters.
DATA_S_SAMEFORMATETC
The returned FORMATETC is the same as the structure passed in the parameters and null is returned in .
DV_E_LINDEX
is not valid.
DV_E_FORMATETC
is not valid.
OLE_E_NOTRUNNING
The object application is not running.
A pointer to the defining the format, medium, and target device for calls to retrieve data.
An output pointer to a FORMATETC containing the most general information possible for a specific rendering.
-or-
null, if the method returns DATA_S_SAMEFORMATETC.
Renders the data that is described in the specified structure and transfers it to the parameter.
The method supports the standard return values E_INVALIDARG, E_UNEXPECTED, and E_OUTOFMEMORY, as well as the following return values:
Return value
Description
S_OK
This call to the method successfully retrieved and placed data in the provided storage medium.
DV_E_LINDEX
is not valid.
DV_E_FORMATETC
is not valid.
DV_E_TYMED
is not valid.
DV_E_DVASPECT
is not valid.
OLE_E_NOTRUNNING
The object application is not running.
STG_E_MEDIUMFULL
An error occurred when allocating the medium.
A pointer to the defining the format, medium, and target device for calls to retrieve data.
A pointer to the indicating the storage medium containing the returned data.
Renders the data that is described in the specified structure and transfers it to the parameter.
The method supports the standard return values E_INVALIDARG, E_UNEXPECTED, and E_OUTOFMEMORY, as well as the following return values:
Return value
Description
S_OK
This call to the method successfully retrieved and placed data in the provided storage medium.
DV_E_LINDEX
is not valid.
DV_E_FORMATETC
is not valid.
DV_E_TYMED
is not valid.
DV_E_DVASPECT
is not valid.
OLE_E_NOTRUNNING
The object application is not running.
STG_E_MEDIUMFULL
An error occurred when allocating the medium.
A pointer to the defining the format, medium, and target device for calls to retrieve data.
A pointer to the indicating the storage medium containing the returned data.
Retrieves a value indicating whether the implementer can render the data that is contained in the parameter.
The method supports the standard return values E_INVALIDARG, E_UNEXPECTED, and E_OUTOFMEMORY, as well as the following return values:
Return value
Description
S_OK
A subsequent call to the method probably will be successful.
DV_E_LINDEX
is not valid.
DV_E_FORMATETC
is not valid.
DV_E_TYMED
is not valid.
DV_E_DVASPECT
value.
OLE_E_NOTRUNNING
The object application is not running.
A pointer to the defining the format, medium, and target device for calls to retrieve data.
Transfers the data that is contained in the structure, referenced by , to this instance of the interface.
The method supports the standard return values E_FAIL, E_INVALIDARG, E_UNEXPECTED, and E_OUTOFMEMORY, as well as the following return values:
Return value
Description
S_OK
This call to the method successfully transferred the data.
E_NOTIMPL
The method is not implemented for the data object implementing the .
DV_E_LINDEX
is not valid.
DV_E_FORMATETC
is not valid.
DV_E_TYMED
is not valid.
DV_E_DVASPECT
is not valid.
OLE_E_NOTRUNNING
The object application is not running.
A pointer to the defining the format for the data object implementing the to use when interpreting the data contained in the storage medium.
A pointer to the defining the storage medium for the method to use to pass the data.
true to specify that the called data object implementing the owns the storage medium after the call and must free the medium after it has been used; otherwise, false to specify the caller retains ownership of the storage medium and the data object uses the medium for the duration of the call only.
Used to enumerate an array of structures.
Enables a snap-in to add items to an existing shortcut menu.
Enables a snap-in to add items to an existing shortcut menu.
A pointer to the on the data object of the menu to which the is adding items to the shortcut menu.
A pointer to an that can add items to the shortcut menu.
The MMC-defined menu-item insertion points that can be used.
The Microsoft Management Console (MMC) calls the method when one of the shortcut menu items that you added is selected.
The command identifier of the menu item.
A pointer to the on the object for which the shortcut menu was displayed.
Enables a snap-in component to add property pages to the property sheet of an item.
Adds pages to a property sheet.
Return Value
Description
S_OK
The successfully added the property sheet pages.
S_FALSE
The added no property sheet pages.
E_UNEXPECTED
An unexpected error occurred.
E_INVALIDARG
One or more parameters are not valid.
A pointer to the .
The handle to use to route the notification message to the appropriate or .
A pointer to the on the object containing context information about the scope or result item.
Determines whether the object requires pages.
Return Value
Description
S_OK
Properties exist for this data object.
E_UNEXPECTED
An unexpected error occurred.
E_INVALID
The parameter is not valid.
Any other error code
No pages are supplied for the data object.
A pointer to the on the object containing context information about the scope or result item.
Enables a snap-in component to add property pages to the property sheet of an item.
Adds pages to a property sheet.
Return Value
Description
S_OK
The method successfully added the property sheet pages.
S_FALSE
The method added no property sheet pages.
E_UNEXPECTED
An unexpected error occurred.
E_INVALIDARG
One or more parameters are not valid.
A pointer to the .
The handle to use to route the notification message to the appropriate or .
A pointer to the on the object containing context information about the scope or result item.
Retrieves the watermark and header bitmaps for wizard sheets that are implemented as Wizard 97–style wizards.
Return Value
Description
true if the watermark and header bitmaps should be stretched rather than tiled; otherwise, false.
The on the object containing context information about the scope or result item.
The handle to a bitmap that serves as the watermark for Wizard 97 pages.
The handle to a bitmap that serves as the header for Wizard 97 pages.
The handle to a palette used for the bitmaps specified by and .
A return value: true if the watermark and header bitmaps should be stretched rather than tiled; otherwise, false.
Determines whether the object requires pages.
Return value
Description
S_OK
Properties exist for this data object.
E_UNEXPECTED
An unexpected error occurred.
E_INVALID
The parameter is not valid.
Any other error code
No pages are supplied for the data object.
A pointer to the on the object containing context information about the scope or result item.
Adds the property pages for the snap-in to a property sheet.
Adds a page to a property sheet.
The handle to a property sheet page to add to a property sheet.
Removes a page from a property sheet.
The handle to a property sheet page to remove from a property sheet.
Allows the console to get copyright and version information and images for the static folder from a snap-in.
Obtains the provider name of the snap-in.
A return value that contains the provider name of the snap-in and is passed uninitialized.
Allows the console to get the text for the description box on the About property page for the snap-in.
A return value that contains the text for the description box on an About property page and is passed uninitialized.
Allows the console to get the main icon that is used in the About property page for a snap-in.
A return value that contains the handle to the main icon of the snap-in used by the About property page and is passed uninitialized.
Allows the console to get the version number for the snap-in.
A return value that contains text specifying the version number for the snap-in and is passed uninitialized.
Allows the console to get the static folder images for the scope and results panes.
A return value that contains the handle to a small icon (16 x 16 pixels) in either the scope or results view pane.
A return value that contains the handle to a small open folder icon (16 x 16 pixels).
A return value that contains the handle to a large icon (32 x 32 pixels).
A return value that contains a structure that specifies the color used to generate a mask.
Specifies the types of controls that can appear on the control bar.
A toolbar control.
A drop-down menu control.
A combo box control.
Filled by the method to specify the title text, optional button text, and optional button command identification for a list-view task pad.
Specifies all the data that is required to set up an individual task on a task pad.
Specifies the type of image and data that is required to use the image to display a task or the background on a task pad.
Contains values that are used to create buttons on a toolbar.
Specifies a callback function that a property sheet calls when a page is created and when the page is about to be destroyed.
The value of .
Reserved; must be null.
An action flag specifying that a page or a dialog box for a page is being created or a page is being destroyed.
A pointer to a structure defining the page being created or destroyed.
Specifies or receives the attributes of result items in the results pane of the snap-in.
Specifies items to be inserted into the scope pane.
Specifies the number of enumerated items.
Sets an MMC_CALLBACK value or a pointer to a null-terminated string.
Specifies a console-supplied unique identifier for this instance of the structure.
Specifies a user-supplied 32-bit value to associate with this instance of the structure.
Specifies an array of flags indicating which members of this instance of the structure contain valid data.
Specifies the virtual image index in the image list when this instance of the structure is not selected.
Specifies the virtual image index in the image list when this instance of the structure is selected.
Specifies the state mask for the item.
For the method, the field returns MMC_SCOPE_ITEM_STATE_EXPANDEDONCE if this instance of the structure has been expanded at least one time; otherwise, returns 0 (zero) if the item has not been expanded.
A console-supplied unique item identifier for this instance of the structure.
Provides a generalized global memory handle to use for data transfer operations.