IWMSIPAdmin Interface

The IWMSIPAdmin interface is exposed by the WMS IP Address Authorization plug-in that enables restricted client access to content based on IP addresses. You can use the methods in the following table to create IP address lists.

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

Method	Description
get_AccessListOptions	Retrieves an enumeration value indicating default access permissions for unspecified IP addresses.
get_AllowIP	Retrieves an IWMSIPListIWMSIPList Interface containing a collection of IP addresses that a client can use to connect to the server.
get_DisallowIP	Retrieves an IWMSIPList interface containing a collection of IP addresses that a client cannot use to connect to the server.
put_AccessListOptions	Specifies an enumeration value indicating default access permissions for unspecified IP addresses.

Example

The following example illustrates how to retrieve a pointer to an IWMSIPAdmin 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;

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;

EXIT:
    // TODO: Release temporary COM objects and uninitialize COM.

See Also

Concepts

System Plug-in Interfaces (C++)