La méthode ApplyIncrementalChangeToCollection effectue l'application d'un sous-ensemble des propriétés dans ce Setting sur ...

La méthode ApplyIncrementalChangeToCollection effectue l'application d'un sous-ensemble des propriétés dans ce Setting sur la Collection référencée ManagedSystemElement. La conséquence est l'exécution de la méthode ApplyIncrementalChangeToMSE sur chacun des Elements agrégés par la Collection. Si la valeur d'entrée ContinueOnError est False, cette méthode applique le Setting à tous les Elements de la Collection jusqu'à ce qu'une erreur soit rencontrée, auquel cas la méthode s'interrompt, enregistre la clé de l'Element ayant provoqué l'erreur dans le tableau CanNotApply, puis émet le code de retour 2. Si la valeur d'entrée ContinueOnError est True, cette méthode applique le Setting à tous les ManagedSystemElements de la Collection et consigne dans le tableau CanNotApply les Elements ayant échoué. Pour ces derniers, le traitement se poursuivra jusqu'à ce que la méthode soit appliquée à tous les Elements de la Collection, quelles que soient les erreurs rencontrées. La clé de chaque ManagedSystemElement auquel le Setting n'a pas pu être appliqué est enregistrée dans le tableau CanNotApply. Cette méthode prend quatre paramètres d'entrée : Collection (la Collection d'Elements à laquelle le Setting est appliqué), TimeToApply (qui, étant de type datetime, peut être une heure spécifique ou un intervalle de temps), ContinueOnError (la valeur True indique qu'il faut poursuivre le traitement lorsqu'une erreur est rencontrée) et MustBeCompletedBy (qui indique le délai d'achèvement requis pour la méthode), ainsi qu'un tableau PropertiesToApply (qui contient une liste des noms de propriétés dont les valeurs seront appliquées). Si une propriété ne figure pas dans cette liste, elle est ignorée par la méthode Apply. Si le tableau a la valeur Null, s'il est vide ou s'il contient la chaîne « ALL » comme nom de propriété, toutes les propriétés du Settings sont appliquées. S'il a la valeur « NONE », aucune propriété de Settings n'est appliquée. 
La valeur de retour doit être 0 si le Setting a été correctement appliqué à la Collection référencée, 1 si la méthode n'est pas prise en charge, 2 si le Setting n'a pas été appliqué dans les délais spécifiés,  3 si le Setting ne peut pas être appliqué avec la valeur d'entrée de ContinueOnError, et tout autre nombre si une erreur s'est produite. Un paramètre de sortie, CanNotApply, est défini. Il s'agit d'un tableau de chaînes qui répertorie les clés des ManagedSystemElements auxquels le Setting n'a pas pu être appliqué. Ce paramètre de sortie n'est significatif que si le paramètre ContinueOnError a la valeur True. 
Dans une sous-classe, l'ensemble de codes de retour possibles pourrait être spécifié à l'aide d'un qualificateur ValueMap sur la méthode. Les chaînes vers lesquelles le contenu de ValueMap est « traduit » peuvent également être spécifiées dans la sous-classe en tant que qualificateur de tableau de valeurs. 
Remarque : si une erreur se produit lors de l'application du Setting à un ManagedSystemElement dans la Collection, l'Element doit être configuré comme il l'était initialement lorsque la tentative d'application a commencé. Autrement dit, l'Element ne doit pas être laissé dans un état intermédiaire.