IWMSBroadcastPublishingPoint2 Interface

You can use the IWMSBroadcastPublishingPoint2 interface to enable Startup Profile and to automatically restart a broadcast publishing point whenever Windows Media Services starts.

Note

Except for Windows Server 2003, Web Edition, this interface is available only on the x64-based versions of Windows Server 2003 and on the 32-bit versions of Windows Server 2003 with Service Pack 1. Not all editions of Windows Server 2003 support all methods of this interface. Check the platform requirements at the bottom of each method page to learn which editions of Windows Server 2003 support each method. This interface is also available on Window Server 2008.

In addition to the methods inherited from IWMSBroadcastPublishingPoint, the IWMSBroadcastPublishingPoint2 interface exposes the following methods.

Method	Description
get_AllowStartupProfile	Retrieves a Boolean value that indicates whether the publishing point allows the use of Startup Profile.
get_EnableStartVRootOnServiceStart	Retrieves a Boolean value that indicates whether the publishing point automatically starts when Windows Media Services starts.
put_AllowStartupProfile	Specifies a Boolean value that indicates whether the publishing point allows the use of Startup Profile.
put_EnableStartVRootOnServiceStart	Specifies a Boolean value that indicates whether the publishing point automatically starts when Windows Media Services starts.

Example

The following example illustrates how to retrieve a pointer to an IWMSBroadcastPublishingPoint2 interface.

#include <windows.h>
#include <atlbase.h>    // Includes CComBSTR.
#include "wmsserver.h"

// Declare variables and interfaces.
IWMSServer                    *pServer;
IWMSPublishingPoints          *pPubPoints;
IWMSPublishingPoint           *pPubPoint;
IWMSBroadcastPublishingPoint2 *pBCPubPoint2;

HRESULT                       hr;
CComVariant                   varIndex;
long                          lCount;

// Initialize the COM library and retrieve a pointer
// to an IWMSServer interface.
hr = CoInitialize(NULL);
hr = CoCreateInstance(CLSID_WMSServer,
                      NULL,
                      CLSCTX_ALL,
                      IID_IWMSServer,
                      (void **)&pServer);
if (FAILED(hr)) goto EXIT;

// Retrieve a pointer to the IWMSPublishingPoints
// interface and retrieve the number of publishing points.
hr = pServer->get_PublishingPoints(&pPubPoints);
if (FAILED(hr)) goto EXIT;

hr = pPubPoints->get_Count(&lCount);
if (FAILED(hr)) goto EXIT;

// Retrieve each publishing point and query the
// IWMSBroadcastPublishingPoint2 interface.
for (long x = 0; x < lCount; x++)
{
    varIndex = x;
    hr = pPubPoints->get_Item(varIndex, &pPubPoint);
    if (FAILED(hr)) goto EXIT;

    // Retrieve the type of publishing point.
    WMS_PUBLISHING_POINT_TYPE pptType;
    hr = pPubPoint->get_Type(&pptType);
    if (FAILED(hr)) goto EXIT;

    if (pptType == WMS_PUBLISHING_POINT_TYPE_BROADCAST)
    {
        hr = pPubPoint->QueryInterface(IID_IWMSBroadcastPublishingPoint2,
                                      (void **)&pBCPubPoint2);
        if (FAILED(hr)) goto EXIT;

        pBCPubPoint2->Release();
    }

    // Release temporary COM objects.
    pPubPoint->Release();
}

EXIT:
    // TODO: Release temporary COM objects and uninitialize COM.

See Also

Reference

IWMSBroadcastPublishingPoint Interface

Concepts

Server Object Model Interfaces (C++)