WMS_EVENT_LOGICAL_URL_TRANSFORM

  • Article

banner art

Previous Next

WMS_EVENT_LOGICAL_URL_TRANSFORM

The server has requested permission to map the logical URL requested by a client (for example, rtsp://server1/movie1.wmv) to a publishing point. Only an authorization plug-in can register to receive this event. To authorize the event, the plug-in must return S_OK. To deny access, it must return E_ACCESSDENIED. If this event is not authorized, the server disconnects the client. The following values are associated with this event.

Value Description
WMS_PRESENT_ORIGINAL_REQUEST_NAME The logical URL originally requested by the client. A plug-in must not change this value.
WMS_PRESENT_REQUEST_NAME Initially, this contains the same value as the WMS_PRESENT_ORIGINAL_REQUEST_NAME property. However, if you want to redirect the client, you can set the new URL here and return NS_E_REDIRECT from your plug-in. The server then disconnects and redirects the client.
  • Note   You cannot use an authorization plug-in to redirect to an alternate proxy server, but you can create a cache proxy plug-in that examines the presentation context filled by the authorization plug-in and instructs the server to perform a proxy redirection to the URL contained in the WMS_PRESENT_REQUEST_NAME property. However, after your authorization plug-in fills this property, it must return S_OK rather than NS_E_REDIRECT. The server sends the presentation context to the cache plug-in when it calls QueryCache on the IWMSCacheProxy interface. Server-level plug-ins receive this event; however, publishing-point-level plug-ins will not. For more information, see Event Level.

See Also

Previous Next