Método CHStringArray::SetSize (chstrarr.h)

Artículo
02/26/2024

[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