rmaupgrd.pas

Delphi源码REAlRMSDK.rar

unit RmaUpgrd;

interface

uses
  PnTypes, RmaPckts;

//***************************************************************************
//
//  $Id: rmaupgrd.h,v 1.12 2000/04/24 23:15:41 rahul Exp $
//
//  Copyright (C) 1995-1999 RealNetworks, Inc. All rights reserved.
//
//  http://www.real.com/devzone
//
//  This program contains proprietary
//  information of Progressive Networks, Inc, and is licensed
//  subject to restrictions on use and distribution.
//
//  Auto Upgrade Interfaces
//
//

// Enumeration for the upgrade types

type
  _RMAUpgradeType = (eUT_Required, eUT_Recommended, eUT_Optional);
  {$EXTERNALSYM _RMAUpgradeType}
  RMAUpgradeType = _RMAUpgradeType;
  {$EXTERNALSYM RMAUpgradeType}

//***************************************************************************
//
//  Interface:
//
//  	IRMAUpgradeCollection
//
//  Purpose:
//
//	Interface provided by the Context. This interface allows collection
//	of upgrade components by the client core and it's delegates
//	(i.e. renderer plugins etc.)
//
//  IID_IRMAUpgradeCollection
//
//	{00002500-0901-11d1-8B06-00A024406D59}
//
//

const
  IID_IRMAUpgradeCollection: TGUID = '{00002500-0901-11d1-8B06-00A024406D59}';
  {$EXTERNALSYM IID_IRMAUpgradeCollection}

type
  IRMAUpgradeCollection = interface (IUnknown)
  ['{00002500-0901-11d1-8B06-00A024406D59}']

    //***********************************************************************
    //	Method:
    //		IRMAUpgradeCollection::Add
    //	Purpose:
    //		Adds the specified upgrade information to the collection
    //
    //

    function Add(upgradeType: RMAUpgradeType; pPluginId: IRMABuffer;
      majorVersion, minorVersion: UINT32): UINT32; stdcall;

    //***********************************************************************
    //	Method:
    //		IRMAUpgradeCollection::Remove
    //	Purpose:
    //		Remove the specified item from the collection
    //
    //

    function Remove(index: UINT32): HRESULT; stdcall;

    //***********************************************************************
    //	Method:
    //		IRMAUpgradeCollection::RemoveAll
    //	Purpose:
    //		Remove all items from the collection
    //
    //

    function RemoveAll: HRESULT; stdcall;

    //***********************************************************************
    //	Method:
    //		IRMAUpgradeCollection::GetCount
    //	Purpose:
    //		get the count of the collection
    //
    //

    function GetCount: UINT32; stdcall;

    //***********************************************************************
    //	Method:
    //		IRMAUpgradeCollection::GetAt
    //	Purpose:
    //		get the specified items upgrade information
    //
    //

    function GetAt(index: UINT32; var upgradeType: RMAUpgradeType; pPluginId: IRMABuffer;
      var majorVersion, minorVersion: UINT32): HRESULT; stdcall;

  end;
  {$EXTERNALSYM IRMAUpgradeCollection}

//***************************************************************************
//
//  Interface:
//
//  	IRMAUpgradeHandler
//
//  Purpose:
//
//	Interface provided by the top-level client application.  This
//	interface allows the client core to request an upgrade.
//
//  IID_IRMAUpgradeHandler:
//
//	{00002501-0901-11d1-8B06-00A024406D59}
//
//

const
  IID_IRMAUpgradeHandler: TGUID = '{00002501-0901-11d1-8B06-00A024406D59}';
  {$EXTERNALSYM IID_IRMAUpgradeHandler}

type
  IRMAUpgradeHandler = interface (IUnknown)
  ['{00002501-0901-11d1-8B06-00A024406D59}']

    //***********************************************************************
    //	Method:
    //		IRMAUpgradeHandler::RequestUpgrade
    //	Purpose:
    //		Ask if user wants to do an upgrade and start an upgrade
    //
    //

    function RequestUpgrade(pComponents: IRMAUpgradeCollection; bBlocking: BOOL): HRESULT; stdcall;

    //***********************************************************************
    //	Method:
    //		IRMAUpgradeHandler::HasComponents
    //	Purpose:
    //		Check if required components are present on the system.
    //  Returns:
    //		PNR_OK - components are here, no upgrade required;
    //			 all components are removed from pComponents.
    //          PNR_FAIL - some components are missing;
    //                   pComponents contains only those components
    //			 that need upgrade.
    //
    //

    function HasComponents(pComponents: IRMAUpgradeCollection): HRESULT; stdcall;

  end;
  {$EXTERNALSYM IRMAUpgradeHandler}

implementation

end.