Método CHStringArray::GetAt(int) (chstrarr.h)

Artigo
02/23/2024

[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 GetAt obtém o elemento de matriz no índice especificado.

Sintaxe

CHString GetAt(
  int nIndex
);

Parâmetros

nIndex

Um índice inteiro maior ou igual a zero (0) e menor ou igual ao valor retornado por GetUpperBound.

Nota O parâmetro nIndex deve ser maior ou igual a 0. A versão de depuração da biblioteca CHStringArray valida os limites de nIndex; a versão de lançamento não.

Retornar valor

Se o método GetAt for bem-sucedido, ele retornará o elemento de ponteiro CHString atualmente neste índice.

Comentários

Passar um valor negativo ou um valor maior que o valor retornado por GetUpperBound resulta em uma declaração com falha para builds de depuração.

Exemplos

O exemplo de código a seguir mostra o uso de CHStringArray::GetAt.

CHStringArray array;

array.Add( L"String 1" ); // Element 0 
array.Add( L"String 2" ); // Element 1 
assert( array.GetAt( 0 ) == "String 1" );

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