IWMSIPList Interface

banner art

Previous Next

IWMSIPList Interface

The IWMSIPList interface contains a collection of IWMSIPEntry interfaces used by the WMS IP Address Authorization plug-in to allow or disallow client connections based on IP addresses.

In addition to the methods inherited from IDispatch, the IWMSIPList interface exposes the following methods.

Method Description
Add Adds an IWMSIPEntry interface to the IWMSIPList collection.
get_Count Retrieves the number of IWMSIPEntry interfaces in the IWMSIPList collection.
get_Item Retrieves a specific IWMSIPEntry interface from the IWMSIPList collection.
get_length Retrieves the number of IWMSIPEntry interfaces in the IWMSIPList collection. This method is included for JScript compatibility.
Remove Removes a specific IWMSIPEntry interface from the IWMSIPList collection.

Example Code

The following example illustrates how to retrieve a pointer to an IWMSIPList interface.

#include <windows.h>
#include <atlbase.h>    // Includes CComVariant.

// To access system plug-in interfaces, the
// entire type library must be imported as shown.
#import "WMSServerTypeLib.dll" no_namespace named_guids \
                               raw_interfaces_only

// Declare variables and interfaces.
IWMSServer      *pServer;
IWMSPlugins     *pPlugins;
IWMSPlugin      *pPlugin;
IDispatch       *pDispatch;
IWMSIPAdmin     *pIPAdmin;
IWMSIPList      *pIPList;

HRESULT         hr;
CComVariant     varIndex;

// Initialize the COM library and retrieve a pointer
// to an IWMSServer interface.
hr = CoInitialize(NULL);
hr = CoCreateInstance(CLSID_WMSServer,
                      NULL,
                      CLSCTX_ALL,
                      IID_IWMSServer,
                      (void **)&pServer);
if (FAILED(hr)) goto EXIT;

// Retrieve a pointer to an IWMSPlugins interface
// containing event handler plug-ins.
hr = pServer->get_EventHandlers(&pPlugins);
if (FAILED(hr)) goto EXIT;

// Retrieve a pointer to the IWMSPlugin interface
// of the plug-in to be configured.
varIndex = "WMS IP Address Authorization";
hr = pPlugins->get_Item(varIndex, &pPlugin);
if (FAILED(hr)) goto EXIT;

// Retrieve a pointer to the custom interface
// of the plug-in.
hr = pPlugin->get_CustomInterface(&pDispatch);
if (FAILED(hr)) goto EXIT;

// Query the specific administration interface
// for the plug-in.
hr = pDispatch->QueryInterface(IID_IWMSIPAdmin,
                              (void **)&pIPAdmin);
if (FAILED(hr)) goto EXIT;

// Retrieve the list of banned IP addresses.
hr = pIPAdmin->get_DisallowIP(&pIPList);
if (FAILED(hr)) goto EXIT;

EXIT:

See Also

Previous Next