COleSafeArray::CreateOneDim

Artykuł
02/27/2013

Tworzy nową jednowymiarowe COleSafeArray obiektu.

void CreateOneDim(
   VARTYPE vtSrc,
   DWORD dwElements,
   const void* pvSrcData = NULL,
   long nLBound = 0 
);

Parametry

vtSrc
Typ podstawowy tablicy (czyli VARTYPE każdego elementu tablicy).
dwElements
Liczba elementów w tablicy.To można zmienić po utworzeniu tablicy z ResizeOneDim.
pvSrcData
Wskaźnik do danych, aby skopiować do tablicy.
nLBound
Dolna granica tablicy.

Uwagi

Funkcja alokuje i inicjuje danych w tablicy, kopiowanie określone dane, jeśli wskaźnik pvSrcData nie jest NULL.

Na błąd, funkcja generuje CMemoryException.

Przykład

VARIANT varColInfo[3];

//initialize VARIANTs
for (int i = 0; i < 3; i++)
   VariantInit(&varColInfo[i]);

// Column Name
varColInfo[0].vt = VT_BSTR;
varColInfo[0].bstrVal = ::SysAllocString(L"Name");

// Column Type
varColInfo[1].vt = VT_UI4;
varColInfo[1].lVal = 1;

COleSafeArray sa;
//create a 1 dimensional safearray of VARIANTs
//& initialize it with varColInfo VARIANT array
sa.CreateOneDim(VT_VARIANT, 2, varColInfo);

//check that the dimension is 2
ASSERT(sa.GetOneDimSize() == 2);

//increase safearray size by 1
sa.ResizeOneDim(3);

// populate the last element of the safearray, (Column Size)
varColInfo[2].vt = VT_I4;
varColInfo[2].lVal = 30;
long el = 2;
sa.PutElement(&el, &varColInfo[2]);