IWMSAdminAnonUser Interface

banner art

Previous Next

IWMSAdminAnonUser Interface

When you enable the WMS Anonymous User Authentication plug-in, a client can attempt to connect to the server without providing a user name or password. The client is granted the access permissions specified for an account that Windows Media Services has been configured to use as the anonymous user account. You can use the IWMSAdminAnonUser interface to retrieve the name of the user account and specify a user name and password for use during the authorization process.

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

Method Description
get_AnonymousUserName Retrieves the name of the Windows Media user account that is used to specify access permissions when an anonymous user connects to a Windows Media server.
get_IsPasswordSet Retrieves a Boolean value indicating whether a password has been associated with anonymous user connections.
SetUserNamePassword Specifies a user name and password for use during the authorization process.

Example Code

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

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 authentication plug-ins.
hr = pServer->get_Authenticators(&pPlugins);
if (FAILED(hr)) goto EXIT;

// Retrieve a pointer to the IWMSPlugin interface
// of the plug-in to be configured.
varIndex = "WMS Anonymous User Authentication";
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_IWMSAdminAnonUser,
                              (void **)&pAdminAnonUser);
if (FAILED(hr)) goto EXIT;

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

See Also

Previous Next