Share via

IWMSPlugin::put_SelectionOrder

  • Article

banner art

Previous Next

IWMSPlugin::put_SelectionOrder

The put_SelectionOrder method specifies a zero-based value that is used by the server to determine the order in which a plug-in will be selected for use.

Syntax

  HRESULT put_SelectionOrder(
  
  long
  
  newVal
  
  );

Parameters

newVal

[in] long that identifies the order.

Return Values

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

Remarks

The selection order is particularly important for authentication and cache proxy plug-ins. For cache proxy plug-ins, the selection order can be used to specify which plug-in should be used as the default plug-in to handle cache proxy requests that other plug-ins do not handle. For authentication plug-ins, the plug-in with the lowest selection order that uses an anonymous authentication scheme, such as the WMS Anonymous User Authentication plug-in, is used first. If anonymous authentication fails, the server will begin trying non-anonymous authentication plug-ins based on their selection order. For all other types of plug-ins in which more than one type of plug-in can be used to process a request, plug-ins are selected for use based on their selection-order value.

Example Code

Requirements

Header: wmsserver.h.

Library: WMSServerTypeLib.dll.

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

See Also

Previous Next