IWMProfileManager::SaveProfile method (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 SaveProfile method saves a profile into an XML-formatted string.
Syntax
HRESULT SaveProfile(
[in] IWMProfile *pIWMProfile,
[in] WCHAR *pwszProfile,
[in, out] DWORD *pdwLength
);
Parameters
[in] pIWMProfile
Pointer to the IWMProfile interface of the object containing the profile data to be saved.
[in] pwszProfile
Pointer to a wide-character null-terminated string containing the profile. Set this to NULL to retrieve the length of string required.
[in, out] pdwLength
On input, specifies the length of the pwszProfile string. On output, if the method succeeds, specifies a pointer to a DWORD containing the number of characters, including the terminating null character, required to hold the profile.
Return value
The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.
| Return code | Description |
|---|---|
|
The method succeeded. |
|
There is not enough available memory. |
|
Either the pIWMProfile or pdwLength parameter is NULL. |
Remarks
You should make two calls to SaveProfile. On the first call, pass NULL as pwszProfile. On return, the value of pdwLength is set to the length required to hold the profile in string form. Then you can allocate the required amount of memory for the buffer and pass a pointer to it as pwszProfile on the second call.
This string contains all the profile information. It must not be displayed to users, and should not be altered. To change the settings in a saved profile, load it using the profile manager and change the settings using the profile object and related objects.
To save a custom profile for later use, you must save the content of the returned string in a .prx file. For more information on .prx files, see Profiles.
To load a saved custom profile, copy the contents of the profile from the .prx file to a string and use IWMProfileManager::LoadProfileByData.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 2000 Professional [desktop apps only],Windows Media Format 7 SDK, or later versions of the SDK |
| Minimum supported server | Windows 2000 Server [desktop apps only] |
| Target Platform | Windows |
| Header | wmsdkidl.h (include Wmsdk.h) |
| Library | Wmvcore.lib; WMStubDRM.lib (if you use DRM) |