Método CHStringArray::SetSize (chstrarr.h)
[La clase CHStringArray forma parte del marco del proveedor de WMI que ahora se considera en estado final y no habrá más desarrollo, mejoras o actualizaciones disponibles para problemas no relacionados con la seguridad que afecten a estas bibliotecas. Las API de MI se deben usar para todo el nuevo desarrollo.]
El método SetSize establece el tamaño de una matriz vacía o existente.
Sintaxis
void throw(CHeap_Exception) SetSize(
int nNewSize,
int nGrowBy
);
Parámetros
nNewSize
Nuevo tamaño de matriz (número de elementos). El valor debe ser mayor o igual que 0 (cero).
nGrowBy
Número mínimo de ranuras de elemento que se van a asignar si es necesario un aumento de tamaño.
Valor devuelto
Este método no devuelve ningún valor.
Comentarios
El método SetSize asigna memoria si es necesario. Si el nuevo tamaño es menor que el tamaño anterior, la matriz se trunca y se libera toda la memoria no utilizada. Para mejorar la eficacia, llame a SetSize para establecer el tamaño de la matriz antes de usarlo. Esto evita la necesidad de reasignar y copiar la matriz cada vez que se agrega un elemento.
El parámetro nGrowBy afecta a la asignación de memoria interna mientras la matriz crece. Su uso nunca afecta al tamaño de la matriz tal como lo notifica GetSize y GetUpperBound.
Ejemplos
Vea el ejemplo de CHStringArray::GetData.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista |
| Servidor mínimo compatible | Windows Server 2008 |
| Plataforma de destino | Windows |
| Encabezado | chstrarr.h (incluya FwCommon.h) |
| Library | FrameDyn.lib |
| Archivo DLL | FrameDynOS.dll; FrameDyn.dll |