The user context contains name-value pairs that describe a client connected to the server. There is a unique context for each client, and it lasts only as long as the user is connected to the server. The following table identifies the context values defined by Windows Media Services.
Note The MMS protocol is mentioned in some of the descriptions in the following table. However, the MMS protocol is not supported in Windows Server 2008 operating systems.
Value (data type)
Contains the name of the user agent for the client. You can use this to differentiate a player from a distribution connection. For more information about user agents, see Identifying a Cache Proxy Server.
Contains an IUnknown pointer that you can use to retrieve a pointer to an IWMSAuthenticationContext interface used to authenticate a client. The IWMSAuthenticationContext interface implements an authentication plug-in. You can call the GetAndQueryIUnknownValue method on the IWMSContext interface to retrieve a pointer to IWMSAuthenticationContext.
Contains the cookie sent by the client to the server.
Contains the value of the "Set-Cookie" headers sent by the upstream server to the proxy. The proxy server propagates this value downstream.
Contains the protocol used to communicate with the client. This may be one of the following values:
WMS_MMS_PROTOCOL_NAME WMS_RTSP_PROTOCOL_NAME WMS_HTTP_PROTOCOL_NAME WMS_UNKNOWN_PROTOCOL_NAME
Contains the client GUID identifying an instance of the client software. This GUID is normally generated on the client when installed, although users can explicitly conceal it for privacy.
Contains the client ID. This number is randomly generated by the server and assigned to a connected client. Each ID is unique.
Contains the IP address of the client.
Contains the IP address of the client in a dotted quad format.
Contains the link bandwidth specified when the client issued a play request.
Contains the user name of the client. If the user is authenticated by using an anonymous authentication plug-in, the user name is WMUS_computername. Otherwise, this context value contains the name with which the user logged onto the network.
Contains the number of the port on the client computer, in host byte order, to which the server is connected.
Contains an IUnknown pointer that you can use to retrieve a pointer to an IWMSContext interface containing the current presentation context for the client. You can call the GetAndQueryIUnknownValue method on the IWMSContext interface to retrieve a pointer to IWMSContext.
Contains the user agent of the original client. When a server connects to an origin server, it provides the original client's user agent in the header. This value is saved so that the appropriate limits and actions can be applied, based upon whether the client is a player or a server.
Contains the referrer URL for the client.
Contains a comma-delimited list of downstream proxy servers. This is updated for each RTSP and HTTP request received but is set only once for MMS. For RTSP and HTTP, the list contains all of the via headers of the downstream proxy servers through which the content passed. For more information about via headers, see Identifying a Cache Proxy Server.
Contains a comma-delimited list of upstream proxy servers. This is updated for each RTSP and HTTP request received but is never set for MMS. For RTSP and HTTP, the list contains all of the via headers of the upstream proxy servers through which the content passed. For more information about via headers, see Identifying a Cache Proxy Server.
IWMSAuthenticationContextIWMSAuthenticationContext Object (Visual Basic .NET)
IWMSContext.GetAndQueryIUnknownValueIWMSContext.GetAndQueryIUnknownValue (Visual Basic .NET)