WM_READER_CLIENTINFO structure

The WM_READER_CLIENTINFO structure describes the client reader (player) accessing the media stream.

Syntax


typedef struct _WMReaderClientInfo {
  DWORD  cbSize;
  WCHAR  *wszLang;
  WCHAR  *wszBrowserUserAgent;
  WCHAR  *wszBrowserWebPage;
  QWORD  qwReserved;
  LPARAM *pReserved;
  WCHAR  *wszHostExe;
  QWORD  qwHostVersion;
  WCHAR  *wszPlayerUserAgent;
} WM_READER_CLIENTINFO;

Members

cbSize

Size of the structure in bytes.

wszLang

Two-letter or three-letter language code.

wszBrowserUserAgent

The browser's user-agent string.

wszBrowserWebPage

Web page that contains the plug-in.

qwReserved

Reserved.

pReserved

Unused. See Remarks.

wszHostExe

Host application's .exe file; for example, Iexplore.exe.

qwHostVersion

Version number of the host application. The value is four unsigned WORD values packed into a 64-bit integer. When the client information is logged, each WORD value is unpacked and translated into its decimal equivalent. For example, if the value is 0x0001000200030004, the version number is logged as "1.2.3.4".

wszPlayerUserAgent

String identifying the player application. For example, "WMPlayer/9.0.0.0" identifies version 9 of the Windows Media Player.

Remarks

In earlier versions of this SDK, the pReserved member was named wszHostUniquePID. The application used this member to specify an ID to send to the server. In the current version, the reader object automatically generates a GUID for the ID, so this structure member is obsolete. It is present only to provide binary compatibility with earlier versions of the SDK.

The GUID generated by the reader object represents a unique user on a particular computer. The reader object stores this value in the registry. If the registry entry does not exist, the SDK dynamically creates it. For more information, see IWMReaderAdvanced2::SetLogClientID.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Version

Windows Media Format 7 SDK, or later versions of the SDK

Header

Wmsdkidl.h (include Wmsdk.h)

See also

IWMReaderAdvanced::SetClientInfo
Structures

 

 

Show: