IDiscRecorder::SetRecorderProperties, méthode (imapi.h)
Accepte un pointeur IPropertyStorage pour un objet avec toutes les propriétés que l’application souhaite modifier. Les paramètres partiellement alloués sont pris en charge. Toutefois, il est recommandé d’interroger un jeu de propriétés à l’aide de GetRecorderProperties, de modifier uniquement les paramètres intéressants, puis d’appeler SetRecorderProperties pour modifier toutes les valeurs simultanément.
Syntaxe
HRESULT SetRecorderProperties(
[in] IPropertyStorage *pPropStg
);
Paramètres
[in] pPropStg
Pointeur vers l’interface IPropertyStorage que l’enregistreur de disque peut utiliser pour récupérer de nouveaux paramètres sur différentes propriétés.
Valeur retournée
S_OK est retourné en cas de réussite, mais d’autres codes de réussite peuvent être retournés à la suite de l’implémentation. Les codes d’erreur suivants sont généralement retournés en cas d’échec de l’opération, mais ne représentent pas les seules valeurs d’erreur possibles :
Notes
Certaines propriétés sont en lecture seule, telles que MaxWriteSpeed. Les propriétés en lecture seule et les propriétés non prises en charge sont ignorées sans générer d’erreur (voir IMAPI_S_PROPERTIESIGNORED). Par exemple, quelqu’un peut envoyer une propriété définie sur cette interface et tenter de modifier les propriétés MaxWriteSpeed et ClearlyNeverHeardOfBefore. Étant donné que MaxWriteSpeed est en lecture seule et que ClearlyNeverHeardOfBefore est une valeur inconnue, les deux propriétés sont ignorées et la méthode réussit.
Après avoir appelé SetRecorderProperties, une application doit vérifier les paramètres de propriété en appelant GetRecorderProperties.
Configuration requise
| Client minimal pris en charge | Windows XP [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | imapi.h |
| Bibliothèque | Uuid.lib |
| DLL | Actxprxy.dll |