Método ICEnroll::enumContainers (xenroll.h)
[Esse método não está mais disponível para uso a partir do Windows Server 2008 e do Windows Vista.]
O método enumContainers recupera os nomes de contêineres para o CSP ( provedor de serviços criptográficos ) especificado pela propriedade ProviderName . Esse método foi definido pela primeira vez na interface ICEnroll .
Sintaxe
HRESULT enumContainers(
[in] LONG dwIndex,
[out] BSTR *pbstr
);
Parâmetros
[in] dwIndex
Especifica a posição ordinal do contêiner cujo nome será recuperado. Especifique zero para o primeiro contêiner.
[out] pbstr
Um ponteiro para uma variável BSTR que recebe o nome do contêiner. Quando terminar de usar o BSTR, libere-o chamando a função SysFreeString .
Retornar valor
C++
O valor retornado é um HRESULT. Um valor de S_OK indica êxito. O valor ERROR_NO_MORE_ITEMS é retornado quando não há mais itens.VB
O valor retornado é uma variável String que representa o nome do contêiner. Uma exceção será gerada se um erro for encontrado ou quando não houver mais itens.Comentários
Se o valor da propriedade ProviderName não tiver sido definido, o valor padrão (geralmente Provedor Criptográfico base da Microsoft) de ProviderName , conforme definido no registro, será usado.
Esse método é desabilitado quando o Controle de Registro de Certificado é executado como um controle com script.
Exemplos
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 | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | xenroll.h |
| Biblioteca | Uuid.lib |
| DLL | Xenroll.dll |