Share via


IWMProfileManager interface (wmsdkidl.h)

[The feature associated with this page, Windows Media Format 11 SDK, is a legacy feature. It has been superseded by Source Reader and Sink Writer. Source Reader and Sink Writer have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use Source Reader and Sink Writer instead of Windows Media Format 11 SDK, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

The IWMProfileManager interface is used to create profiles, load existing profiles, and save profiles. It can be used with both system profiles and application-defined custom profiles. To make changes to a profile, you must load it into a profile object using one of the loading methods of this interface. You can then access the profile data through the use of the interfaces of the profile object.

IWMProfileManager is the default interface of a profile manager object. When you create a new profile manager object using the WMCreateProfileManager function, you obtain a pointer to IWMProfileManager.

Note  When a profile manager object is created it parses all of the system profiles. Creating and releasing a profile manager every time you need to use it will adversely affect performance. You should create a profile manager once in your application and release it only when you no longer need to use it.
 

Inheritance

The IWMProfileManager interface inherits from the IUnknown interface. IWMProfileManager also has these types of members:

Methods

The IWMProfileManager interface has these methods.

 
IWMProfileManager::CreateEmptyProfile

The CreateEmptyProfile method creates an empty profile object. You can use the interfaces of the profile object to configure the profile. When you are done configuring the profile, you can save it to a string using IWMProfileManager::SaveProfile.
IWMProfileManager::GetSystemProfileCount

The GetSystemProfileCount method retrieves the number of system profiles.
IWMProfileManager::LoadProfileByData

The LoadProfileByData method creates a profile object and populates it with data from a stored string. You must use this method to manipulate custom profiles. System profiles should be accessed using either LoadProfileByID or LoadSystemProfile.
IWMProfileManager::LoadProfileByID

The LoadProfileByID method loads a system profile identified by its globally unique identifier. To load a custom profile, use IWMProfileManager::LoadProfileByData.
IWMProfileManager::LoadSystemProfile

The LoadSystemProfile method loads a system profile identified by its index. If you do not know the index of the desired system profile, you must use IWMProfileManager::LoadProfileByID. To load a custom profile, use IWMProfileManager::LoadProfileByData.
IWMProfileManager::SaveProfile

The SaveProfile method saves a profile into an XML-formatted string.

Requirements

Requirement Value
Target Platform Windows
Header wmsdkidl.h

See also

IWMProfileManager2 Interface

Interfaces

Profile Manager Object

Profile Object

Using System Profiles

Working with Profiles