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

Artigo
03/04/2024

[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