La méthode ApplyToCollection effectue l'application du Setting sur la Collection référencée de ManagedSystemElements. La ...

La méthode ApplyToCollection effectue l'application du Setting sur la Collection référencée de ManagedSystemElements. La conséquence est l'exécution de la méthode ApplyToMSE 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. En cas d'erreur, 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). 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 impartis, 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.