Il metodo ApplyIncrementalChangeToCollection esegue l'applicazione di un sottoinsieme di proprietà nell'impostazione nella ...

Il metodo ApplyIncrementalChangeToCollection esegue l'applicazione di un sottoinsieme di proprietà nell'impostazione nella raccolta di ManagedSystemElement di riferimento. L'effetto del metodo è l'esecuzione del metodo ApplyIncrementalChangeToMSE su ogni elemento aggregato nella raccolta. Se il valore di input ContinueOnError è false, il metodo applica l'impostazione a tutti gli elementi nella raccolta fino a quando non si verifica un errore. In caso di errore, l'esecuzione del metodo viene interrotta, la chiave dell'elemento che causa l'errore viene registrata nella matrice CanNotApply e viene restituito il codice 2. Se il valore di input ContinueOnError è true, il metodo applica l'impostazione a tutti i ManagedSystemElement nella raccolta e restituisce gli elementi in errore nella matrice CanNotApply. In quest'ultimo caso l'elaborazione continuerà fino all'applicazione del metodo a tutti gli elementi nella raccolta, indipendentemente dagli eventuali errori rilevati. La chiave di ogni ManagedSystemElement a cui non è possibile applicare l'impostazione viene registrata nella matrice CanNotApply. Il metodo accetta quattro parametri di input: Collection (raccolta degli elementi a cui applicare l'impostazione), TimeToApply (valore di tipo datetime che può rappresentare un'ora specifica o un intervallo di tempo), ContinueOnError (true indica di continuare l'elaborazione in caso di errore), MustBeCompletedBy (che indica il tempo di completamento richiesto per il metodo) e una matrice PropertiesToApply (che contiene un elenco dei nomi delle proprietà di cui verranno applicati i valori). Le eventuali proprietà non incluse in questo elenco verranno ignorate durante l'applicazione. Se la matrice è Null o vuota o contiene la stringa "ALL" come nome di proprietà, verranno applicate tutte le proprietà dell'impostazione. Se l'impostazione è "NONE", non verrà applicata alcuna proprietà. 
Il valore restituito deve essere 0 se l'impostazione viene applicata correttamente alla raccolta di riferimento, 1 se il metodo non è supportato, 2 se l'impostazione non può essere applicata entro i tempi specificati, 3 se l'impostazione non può essere applicata con il valore di input ContinueOnError e qualsiasi altro numero se si verifica un errore. Esiste un parametro di output definito, CanNotApplystring, ovvero una matrice che elenca le chiavi dei ManagedSystemElement a cui non può essere applicata l'impostazione. Questo parametro di output è significativo solo se il parametro ContinueOnError è true. 
In una sottoclasse, si potrebbe specificare il set di possibili codici restituiti tramite un qualificatore ValueMap nel metodo. Anche le stringhe in cui viene convertito il contenuto di ValueMap possono essere specificate nella sottoclasse come un qualificatore della matrice Values. 
Nota: se si verifica un errore in fase di applicazione dell'impostazione a un ManagedSystemElement nella raccolta, l'elemento deve essere configurato con lo stesso stato esistente al momento del tentativo di applicazione, ovvero non deve essere lasciato in stato indeterminato.