COleSafeArray::PutElement

privatevoid PutElement ( long * rgIndices, LPVOID pvData );

Parâmetros

rgIndices

Ponteiro para uma matriz de índices para cada dimensão da matriz.

pvData

Ponteiro para os dados para atribuir a matriz. Tipos variantes VT_DISPATCH, VT_UNKNOWNe VT_BSTR são ponteiros e não exigem outro nível de engano.

Observações

Chame essa função para atribuir um único elemento na matriz. Essa função automaticamente chama o Windows funções SafeArrayLock e SafeArrayUnlock antes e depois da atribuição do elemento. Se o elemento de dados é uma Cadeia de caracteres, objeto ou variante, a função copia corretamente e se o elemento existente é uma Cadeia de caracteres, objeto ou variante, ela será desmarcada corretamente.

Observe que você pode ter Múltiplo bloqueios em uma matriz, assim você pode colocar elementos em uma matriz enquanto a matriz está bloqueada por outras operações.

No erro, a função lança um CMemoryException ou COleException.

Visão geral de COleSafeArrayMembros de classe | Gráfico de hierarquia

Co&nsulte tambémnbsp;COleSafeArray::GetElement, SafeArrayPutElement

Index