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