IWMBackupRestoreProps::SetProp method
[SetProp is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions. Instead, use Microsoft PlayReady. ]
The SetProp method adds a property, and specifies its name and value.
Syntax
HRESULT SetProp(
LPCWSTR pszName,
WMT_ATTR_DATATYPE Type,
const BYTE *pValue,
WORD cbLength
);
Parameters
pszName
Pointer to a null-terminated string containing the name.
Type
Pointer to a variable containing one member of the WMT_ATTR_DATATYPE enumeration type. The current implementation of this method accepts only WMT_TYPE_STRING. Specifying a different type causes the method to return E_INVALIDARG.
pValue
Pointer to a byte array containing the value of the property.
cbLength
Length of pValue, in bytes.
Return value
If the method succeeds, it returns S_OK. If it fails, it returns an HRESULT error code.
Remarks
This method is used to set properties that are needed by the other backup restorer object interfaces.
The following table lists the predefined properties.
| Property name | Type | Description |
|---|---|---|
| BackupPath | String | Full path to the location where the backup files must be saved. |
| RestorePath | String | Full path to the location where the backup files can be found and used to restore data. |
Requirements
| 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) |