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