IWMSPublishingPointTotalCounters::get_ConnectedPlayers

  • Article

banner art

Previous Next

IWMSPublishingPointTotalCounters::get_ConnectedPlayers

The get_ConnectedPlayers method retrieves the total number of players connected to the publishing point since the last reset.

Syntax

  HRESULT get_ConnectedPlayers(
  long*  pVal
);

Parameters

pVal

[out] Pointer to a long containing the number of connected players.

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.

Remarks

When clients request content from the server using HTTP 1.0, the total connected players counter on both the server and publishing point levels may be incremented more than once for each client that connects to the server. This is a result of HTTP 1.0 being a connectionless protocol. As a result, the server does not maintain a persistent TCP control connection to the client. Each request from a client results in a new TCP connection to the server that cannot be associated with a specific client session. Because these requests may not be handled by the same thread, this can result in the peak and total connected counters being incremented more than once for a single request for content from a client.

Example Code

  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