IltmmWMProfileManager::LoadProfileByData

#include "ltmm.h"

C Syntax

HRESULT IltmmWMProfileManager_LoadProfileByData(pProfMan, Profile, pVal)

C++ Syntax

HRESULT LoadProfileByData(Profile, pVal)

 

IltmmWMProfileManager *pProfMan;

/* pointer to an interface */

BSTR Profile;

/* string */

IltmmWMProfile **pVal;

/* pointer to a pointer */

Creates a profile object and fills it with the data from the passed string. The passed string is an XML-formatted string saved using IltmmWMProfileManager::SaveProfile.

Parameter

Description

pProfMan

Pointer to an IltmmWMProfileManager interface.

Profile

An XML-formatted string that contains the profile data to load.

pVal

Pointer to a variable to be updated with a pointer to an IltmmWMProfile interface. This interface references the created profile object.

Returns

S_OK

The function was successful.

<> S_OK

An error occurred. Refer to the Error Codes or the HRESULT error codes in the DirectShow documentation.

Comments

This function is used to manipulate custom profiles, while system profiles are accessed using IltmmWMProfileManager::LoadProfileByID or IltmmWMProfileManager::LoadSystemProfile.

If IltmmWMProfileManager::LoadProfileByData succeeds, the caller must free the retrieved interface by calling its Release method.

For more information, refer to the Microsoft documentation for IWMProfileManager::LoadProfileByData at http://msdn.microsoft.com/library/default.asp?url=/library/en-us/wmform11/htm/iwmprofilemanagerloadprofilebydata.asp.

Required DLLs and Libraries

LTMM

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

See Also

Elements:

IltmmWMProfileManager::get_SystemProfileCount, IltmmWMProfileManager::get_SystemProfileVersion, IltmmWMProfileManager::CreateEmptyProfile, IltmmWMProfileManager::LoadProfileByID, IltmmWMProfileManager::LoadSystemProfile, IltmmWMProfileManager::put_SystemProfileVersion, IltmmWMProfileManager::SaveProfile

Topics:

Multimedia Function Group

 

Windows Media Support

Example

For a C example, refer to IltmmWMProfileManager::LoadProfileByID Example for C.

For a C++ example, refer to IltmmWMProfileManager::LoadProfileByID Example for C++.