O método ApplyToCollection executa a aplicação da Definição (Setting) à Coleção de ManagedSystemElements referenciada. O ...

O método ApplyToCollection executa a aplicação da Definição (Setting) à Coleção de ManagedSystemElements referenciada. O efeito líquido é executar o método ApplyToMSE em cada um dos Elementos agregados pela Coleção. Se o valor de entrada ContinueOnError for falso, esse método aplicará a Definição a todos os Elementos na Coleção até encontrar um erro. Em caso de erro, o método interrompe a execução, registra em log a chave do Elemento que causou o erro na matriz CanNotApply e emite o código de retorno 2. Se o valor de entrada ContinueOnError for verdadeiro, esse método aplicará a Definição a todos os ManagedSystemElements na Coleção e relatará os Elementos com falha na matriz CanNotApply. O processo continua até que o método seja aplicado a todos os Elementos na Coleção, mesmo que sejam encontrados erros. A chave de cada ManagedSystemElement ao qual não foi possível aplicar a Definição é registrada em log na matriz CanNotApply. Esse método usa quatro parâmetros de entrada: Collection (a Coleção de Elementos à qual a Definição está sendo aplicada), TimeToApply (quando se trata de datetime, pode ser um horário ou intervalo de tempo específico), ContinueOnError (verdadeiro indica para continuar o processo quando um erro for encontrado) e MustBeCompletedBy (que indica a hora de conclusão exigida para o método). O valor retornado deve ser 0 quando a Definição é aplicada com êxito à Coleção referenciada, 1 quando não há suporte para o método, 2 quando a Definição não foi aplicada dentro dos horários especificados, 3 quando não é possível aplicar a Definição usando o valor de entrada para ContinueOnError e qualquer outro número em caso de erro. Um parâmetro de saída, CanNotApplystring, é definido como uma matriz que lista as chaves dos ManagedSystemElements aos quais não foi possível aplicar a Definição. Esse parâmetro de saída só faz sentido quando o parâmetro ContinueOnError é verdadeiro. 
Em uma subclasse, o conjunto de códigos de retorno possíveis pode ser especificado usando um qualificador ValueMap no método. As cadeias de caracteres nas quais o conteúdo de ValueMap é "traduzido" também podem ser especificadas na subclasse como um qualificador da matriz Values. 
Observação: em caso de erro ao aplicar a Definição a um ManagedSystemElement na Coleção, o Elemento deverá ser configurado como estava quando a tentativa de "aplicação" começou; ou seja, o Elemento não deve ficar em um estado indeterminado.