Método ICEnroll::enumContainers (xenroll.h)
[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 |