Share via


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 IWMSIPEntryIWMSIPEntry 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

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:
    // TODO: Release temporary COM objects and uninitialize COM.

See Also

Reference

IWMSIPEntry Interface

Concepts

System Plug-in Interfaces (C++)