Platform SDK: Broadcast Architecture

IATVEFAnnouncement::SetUserName

Specifies the login name of the content originator of the session, which may not be the same as the person responsible for the content delivery.

HRESULT SetUserName(
  LPOLESTR szUsername
);

Parameters

szUsername
Login name.

Return Value

Returns S_OK if the method succeeds; otherwise, an error code is returned.

Remarks

This method sets the "owner" identifier in the "o=" field, and is required by the SDP protocol (upon which ATVEF announcements are based). The name must NOT contain any spaces.

If the originating host does not support the concept of user IDs, then the value must be set to "-". This is the default value for this field in the announcement data structure, so call SetUserName only if you wish to specify an actual login name.

Requirements

  Windows NT/2000: Requires Windows NT 4.0 SP3 or later.
  Windows 95/98: Requires Windows 98.
  Header: Declared in atvefsnd.idl.
  Import Library: Included as a resource in atvefsnd.dll.