Platform SDK: Broadcast Architecture

IATVEFAnnouncement::AddEmail

Adds an e-mail address at which a content originator can be contacted.

HRESULT AddEmail(
  LPOLESTR szName,
  LPOLESTR szAddress
);

Parameters

szName
Name of the contact person for this show.
szAddress
Contact person's full e-mail address.

Return Value

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

Remarks

This method adds an "e=" field to the announcement without erasing any previous "e=" fields. The SDP protocol, upon which ATVEF announcements are based, requires at least one e-mail address or one phone number where the content originator can be contacted. Multiple e-mail addresses are permitted. Call AddEmail as often as necessary, specifying one name and address with each call. To erase the previous names and addresses, call ClearEmail.

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.

See Also

IATVEFAnnouncement::AddTelephone, IATVEFAnnouncement::ClearTelephone, IATVEFAnnouncement::ClearEmail