Platform SDK: Broadcast Architecture

IATVEFAnnouncement::AddTelephone

Adds a phone number at which at which a content originator can be contacted.

HRESULT AddTelephone(
  LPOLESTR szName,
  LPOLESTR szPhoneNumber
);

Parameters

szName
Name of the contact person for this show.
szPhoneNumber
Phone number as a numeric string. This should be formatted as follows: <country_code> <area_code> <first_part> <second_part>.

The spaces between the number components are required. So, for example, a phone number from the United States would be formatted as follows:

1 888 555 0111

Return Value

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

Remarks

This method adds a "p=" field to the announcement without erasing the previous "p=" 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 phone numbers are permitted. Call AddTelephone as often as necessary, specifying one name and number with each call. To erase the previous names and numbers, call ClearTelephone.

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::AddEmail, IATVEFAnnouncement::ClearEmail, IATVEFAnnouncement::ClearTelephone