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++.