Compartilhar via


Método IEnumCERTVIEWROW::GetMaxIndex (certview.h)

O método GetMaxIndex recupera o valor de índice válido máximo depois que todas as linhas na sequência de enumeração de linhas são referenciadas.

Sintaxe

HRESULT GetMaxIndex(
  [out] LONG *pIndex
);

Parâmetros

[out] pIndex

Um ponteiro para uma variável LONG que contém o valor máximo do índice para a sequência de enumeração de linha. Esse método falhará se pIndex for NULL.

Retornar valor

C++

Se o método for bem-sucedido, o método retornará S_OK e pIndex será definido como o valor de índice máximo para a sequência de enumeração de linha.

Se a passagem para a última linha não tiver ocorrido, esse método falhará com um valor retornado de E_UNEXPECTED.

Se o método falhar, ele retornará um valor HRESULT que indica o erro. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT comuns.

VB

O valor retornado é o valor máximo do índice para a sequência de enumeração de linha. Esse método falhará se a passagem para a última linha não tiver ocorrido.

Comentários

A conclusão bem-sucedida desse método depende de atingir a última linha da sequência de enumeração. O índice máximo de linhas pode ser útil para dimensionar uma barra de rolagem ou uma janela de exibição, mas também pode ser com uso intensivo de recursos para computação, pois requer a avaliação de toda a consulta. Para algumas consultas, os dados de coluna de cada linha devem ser examinados para determinar se estão incluídos na exibição. Depois que o usuário tiver paginado todos os dados ou solicitado explicitamente para prosseguir até o final, o índice máximo de linhas será preservado.

Para navegar pela sequência de enumeração de linha, chame os métodos a seguir.

Método Descrição
IEnumCERTVIEWROW::Reset Move para o início da sequência de enumeração.
IEnumCERTVIEWROW::Next Move para a próxima linha na sequência de enumeração.
IEnumCERTVIEWROW::Skip Ignora um número especificado de linhas.
 

Exemplos

#include <windows.h>
#include <stdio.h>
#include <Certview.h>

long nMax;

//  Determine the maximum row index.
hr = pRow->GetMaxIndex(&nMax);
if (FAILED(hr))
    printf("Failed GetMaxIndex [%x]\n", hr);
else
    printf("Max index is: %d\n", nMax);

Requisitos

Requisito Valor
Cliente mínimo com suporte Nenhum compatível
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho certview.h (inclua Certsrv.h)
Biblioteca Certidl.lib
DLL Certadm.dll

Confira também

IEnumCERTVIEWROW

IEnumCERTVIEWROW::Next

IEnumCERTVIEWROW::Reset

IEnumCERTVIEWROW::Skip