Método IEnumCERTVIEWEXTENSION::Next (certview.h)

Artículo
08/22/2023

El método Next se mueve a la siguiente extensión de la secuencia de enumeración de extensiones.

Sintaxis

HRESULT Next(
  [out] LONG *pIndex
);

Parámetros

[out] pIndex

Puntero a una variable que contiene el valor de índice de la siguiente extensión a la que se hace referencia. Si no hay más extensiones que enumerar, esta variable se establecerá en –1. Este método produce un error si pIndex es NULL.

Valor devuelto

C++

Si el método se ejecuta correctamente, el método devuelve S_OK y ahora se hace referencia a la siguiente extensión. Si no hay más extensiones, se devuelve S_FALSE y el parámetro pIndex se establece en un valor de –1.

Si se produce un error en el método, devuelve un valor HRESULT que indica el error. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.

VB

El valor devuelto es el valor de índice de la extensión a la que ahora hace referencia la secuencia de enumeración de extensión. Si no hay más extensiones para enumerar, el valor devuelto es –1.

Comentarios

Tras completar correctamente este método, se puede acceder al nombre de la extensión, las marcas y el valor a través de los métodos siguientes:

Ejemplos

LONG  Index;
LONG  nCount;

// determine the number of extensions
nCount = 0;
// pEnumExt is previously instantiated IEnumCERTVIEWEXTENSION object
while (S_OK == pEnumExt->Next(&Index))
{
    nCount++;
}
printf("Number of extensions is %d\n", nCount);

Requisitos


Cliente mínimo compatible	No se admite ninguno
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	certview.h (incluya Certsrv.h)
Library	Certidl.lib
Archivo DLL	Certadm.dll