IWMSPublishingPoint::get_Authenticators

  • Article

banner art

Previous Next

IWMSPublishingPoint::get_Authenticators

The get_Authenticators method retrieves an IWMSPlugins interface that contains a collection of authentication plug-ins.

Syntax

  HRESULT get_Authenticators(
  IWMSPlugins**  pVal
);

Parameters

pVal

[out] Pointer to a pointer to an IWMSPlugins interface that contains authentication plug-ins.

Return Values

If the method succeeds, it returns S_OK. If it fails, it returns an HRESULT error code.

Return code Number Description
E_POINTER 0x80004003 Indicates that pVal is a NULL pointer argument.
NS_E_PUBLISHING_POINT_REMOVED 0xC00D145AL Indicates that the publishing point was already removed.

Remarks

There is no limit to the number of plug-ins that can be in this collection. Authentication plug-ins can use any of three methods to identify clients.

  • The plug-in can request that the client supply a password and user name. The password can be encrypted or sent as clear text.
  • The plug-in can identify the client based on logon credentials.
  • The plug-in can ignore passwords, user names, and logon credentials.

If the plug-in is able to authenticate the client, it sends information about the client to the authorization plug-in to determine whether access permission can be granted.

This method calls AddRef internally. To avoid memory leaks, you must call Release when you are finished using the interface.

Example Code

  // Retrieve a pointer to the IWMSPublishingPoints interface
// and retrieve the total count of publishing points.






















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

Requirements

Header: wmsserver.h.

Library: WMSServerTypeLib.dll.

Platform: Windows Server 2003 family, Windows Server 2008 family.

See Also

Previous Next