Share via

IWMSIPAdmin Interface

  • Article

banner art

Previous Next

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 IWMSIPList 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 Code

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:

See Also

Previous Next