IWMSPublishingPoint::put_WrapperPath

banner art

Previous Next

IWMSPublishingPoint::put_WrapperPath

The put_WrapperPath method specifies the path to a wrapper playlist file.

Syntax

  HRESULT put_WrapperPath(
  BSTR  newVal
);

Parameters

newVal

[in] BSTR that contains the path. By default, this parameter is a zero-length string.

Return Values

If the method succeeds, it returns S_OK. If it fails, it returns an HRESULT error code.

Return code Number Description
E_POINTER 0x80004003 Indicates that pVal is a NULL pointer argument.
ERROR_BAD_PATHNAME 0x000000A1 Indicates that pVal does not reference a file with a valid playlist extension.
NS_E_PUBLISHING_POINT_REMOVED 0xC00D145AL Indicates that the publishing point was already removed.
NS_E_WRONG_PUBLISHING_POINT_TYPE 0xC00D1452L Indicates that the method is not supported for cache proxy publishing points.

Remarks

This method is not supported for cache proxy publishing points.

A wrapper playlist can contain references to media files that are streamed before and after the content that is requested by the client. Hence, the media files wrap the requested content. You can use a wrapper playlist to guarantee that every client that is connected to a publishing point renders specific content. In the following wrapper playlist example, media content is inserted before and after the requested content indicated by the "%url%" placeholder:

<seq>
     <media src = "c:\wmpub\wmroot\content1.wmv"
     <media src = "%url%"
     <media src = "c:\wmpub\wmroot\content2.wmv"
</seq>

Example Code

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

Requirements

Header: wmsserver.h.

Library: WMSServerTypeLib.dll.

Platform: Windows ServerĀ 2003 family, Windows ServerĀ 2008 family.

See Also

Previous Next