Platform SDK: Broadcast Architecture

IATVEFSend::SendPackage

Sends a package that has been created with the methods of IATVEFPackage.

HRESULT SendPackage(
  IATVEFPackage *pPackage;
);

Parameters

pPackage
Pointer to the IATVEFPackage interface of an CATVEFPackage object which contains the package to transmit. For more information, see Creating Packages.

Return Value

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

Remarks

There is at most one package associated with a package object at any given time. A package must be closed before it can be sent, and cannot be opened again once it is closed.

If your enhancement requires multiple packages, you should create an CATVEFPackage object for each package. This is necessary because the process of compressing files into a package can be time consuming. Attempting to reuse a CATVEFPackage object can result in delays during an enhancement transmission because your application must wait until the new package is built before it can transmit it.

By creating and configuring multiple CATVEFPackage objects before the transmission, your application can ensure that all packages are created and ready before it starts transmitting the enhancement.

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

Creating Packages, Sending Announcements, Packages, and Triggers