CHStringArray::SetAt (chstrarr.h)
[A classe CHStringArray faz parte do WMI Provider Framework que agora é considerado em estado final e nenhum desenvolvimento, melhoria ou atualização adicional será disponibilizada para problemas não relacionados à segurança que afetarem essas bibliotecas. As APIs de MI devem ser usadas para todos os novos desenvolvimentos.]
O método SetAt define o elemento de matriz no índice especificado.
Sintaxe
void SetAt(
int nIndex,
LPCWSTR newElement
);
Parâmetros
nIndex
Um índice inteiro maior ou igual a zero e menor ou igual ao valor retornado por GetUpperBound.
newElement
O ponteiro do objeto inserido nessa matriz. Um valor NULL é permitido.
Retornar valor
Nenhum
Comentários
O método SetAt não faz com que a matriz aumente. Use SetAtGrow se quiser que a matriz aumente automaticamente.
Verifique se o valor do índice representa uma posição válida na matriz.
Exemplos
O exemplo de código a seguir mostra o uso de CHStringArray::SetAt.
CHStringArray array;
array.Add( L"String 1" ); // Element 0
array.Add( L"String 2" ); // Element 1
array.SetAt( 0, L"String 3" ); // Replace element 0.
assert( array[0] == "String 3" );
O exemplo a seguir resulta em um CHStringArray com dois elementos.
[0] = String 3
[1] = String 2
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista |
| Servidor mínimo com suporte | Windows Server 2008 |
| Plataforma de Destino | Windows |
| Cabeçalho | chstrarr.h (inclua FwCommon.h) |
| Biblioteca | FrameDyn.lib |
| DLL | FrameDynOS.dll; FrameDyn.dll |