IltmmWMProfileManager::SaveProfile

#include "ltmm.h"

C Syntax	HRESULT IltmmWMProfileManager_SaveProfile(pProfMan, Profile, pVal)
C++ Syntax	HRESULT SaveProfile(Profile, pVal)

IltmmWMProfileManager *pProfMan;	/* pointer to an interface */
IltmmWMProfile *Profile;	/* pointer to an interface */
BSTR **pVal;	/* pointer to a string */

Saves a profile to a string buffer, in the form of an XML-formatted string.

Parameter	Description
pProfMan	Pointer to an IltmmWMProfileManager interface.
Profile	Pointer to an IltmmWMProfile interface that references the object containing the profile data to be saved.
pVal	Pointer to a string to be updated with the profile data in the form of an XML-formatted string.

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

The string obtained from this function should not be modified directly. To change the profile settings, load the saved profile using IltmmWMProfileManager::LoadProfileByData and change the settings using the (IltmmWMProfile interface). You can save the string in a file for later use. The file must have a "prx" extension.

Call SysFreeString to free the memory allocated for the string when it is no longer needed.

For more information, refer to the Microsoft documentation for IWMProfileManager::SaveProfile at http://msdn.microsoft.com/library/default.asp?url=/library/en-us/wmform11/htm/iwmprofilemanagersaveprofile.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::LoadProfileByData, IltmmWMProfileManager::LoadProfileByID, IltmmWMProfileManager::LoadSystemProfile, IltmmWMProfileManager::put_SystemProfileVersion
Topics:	Multimedia Function Group
	Windows Media Support

Example

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

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