Metodo CHStringArray::SetSize (chstrarr.h)

Articolo
02/23/2024

[La classe CHStringArray fa parte di WMI Provider Framework, che ora viene considerata in stato finale e non saranno disponibili ulteriori sviluppi, miglioramenti o aggiornamenti per problemi non correlati alla sicurezza che interessano queste librerie. Le API MI devono essere usate per tutti i nuovi sviluppi.

Il metodo SetSize stabilisce le dimensioni di una matrice vuota o esistente.

Sintassi

void  throw(CHeap_Exception) SetSize(
  int nNewSize,
  int nGrowBy
);

Parametri

nNewSize

Nuova dimensione della matrice (numero di elementi). Il valore deve essere maggiore o uguale a 0 (zero).

nGrowBy

Numero minimo di slot di elementi da allocare se è necessario un aumento delle dimensioni.

Valore restituito

Questo metodo non restituisce valori.

Commenti

Se necessario, il metodo SetSize alloca memoria. Se le nuove dimensioni sono inferiori alle dimensioni precedenti, la matrice viene troncata e viene rilasciata tutta la memoria inutilizzata. Per un'efficienza, chiamare SetSize per impostare le dimensioni della matrice prima di usarla. Ciò impedisce la necessità di riallocare e copiare la matrice ogni volta che viene aggiunto un elemento.

Il parametro nGrowBy influisce sull'allocazione interna della memoria durante l'aumento della matrice. L'uso non influisce mai sulle dimensioni della matrice segnalate da GetSize e GetUpperBound.

Esempio

Vedere l'esempio per CHStringArray::GetData.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Windows
Intestazione	chstrarr.h (include FwCommon.h)
Libreria	FrameDyn.lib
DLL	FrameDynOS.dll; FrameDyn.dll