Método ICEnroll::enumContainers (xenroll.h)

Artículo
03/13/2024

[Este método ya no está disponible para su uso a partir de Windows Server 2008 y Windows Vista.]

El método enumContainers recupera los nombres de los contenedores para el proveedor de servicios criptográficos (CSP) especificado por la propiedad ProviderName . Este método se definió por primera vez en la interfaz ICEnroll .

Sintaxis

HRESULT enumContainers(
  [in]  LONG dwIndex,
  [out] BSTR *pbstr
);

Parámetros

[in] dwIndex

Especifica la posición ordinal del contenedor cuyo nombre se recuperará. Especifique cero para el primer contenedor.

[out] pbstr

Puntero a una variable BSTR que recibe el nombre del contenedor. Cuando haya terminado de usar el BSTR, áurelo llamando a la función SysFreeString .

Valor devuelto

C++

El valor devuelto es hrESULT. Un valor de S_OK indica que se ha realizado correctamente. El valor ERROR_NO_MORE_ITEMS se devuelve cuando no hay más elementos.

VB

El valor devuelto es una variable String que representa el nombre del contenedor. Se produce una excepción si se encuentra un error o cuando no hay más elementos.

Comentarios

Si no se ha establecido el valor de la propiedad ProviderName , se usa el valor predeterminado (normalmente proveedor criptográfico base de Microsoft) de ProviderName establecido en el registro.

Este método se deshabilita cuando el control de inscripción de certificados se ejecuta como un control con script.

Ejemplos

BSTR       bstrCon = NULL;
DWORD      nCon = 0;
HRESULT    hr;

// pEnroll is previously instantiated ICEnroll interface pointer
while ( S_OK == pEnroll->enumContainers(nCon, &bstrCon) )
{
    printf("\t%d) %ws\n", nCon++, bstrCon );
    if ( bstrCon )
    {
        SysFreeString( bstrCon );
        bstrCon = NULL;
    }
}

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	xenroll.h
Library	Uuid.lib
Archivo DLL	Xenroll.dll