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

Article
03/06/2024

[Cette méthode n’est plus disponible à partir de Windows Server 2008 et Windows Vista.]

La méthode enumContainers récupère les noms de conteneurs pour le fournisseur de services de chiffrement (CSP) spécifié par la propriété ProviderName . Cette méthode a d’abord été définie dans l’interface ICEnroll .

Syntaxe

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

Paramètres

[in] dwIndex

Spécifie la position ordinale du conteneur dont le nom sera récupéré. Spécifiez zéro pour le premier conteneur.

[out] pbstr

Pointeur vers une variable BSTR qui reçoit le nom du conteneur. Lorsque vous avez terminé d’utiliser le BSTR, libérez-le en appelant la fonction SysFreeString .

Valeur retournée

C++

La valeur de retour est un HRESULT. La valeur S_OK indique la réussite. La valeur ERROR_NO_MORE_ITEMS est retournée lorsqu’il n’y a plus d’éléments.

VB

La valeur de retour est une variable String qui représente le nom du conteneur. Une exception est levée si une erreur est rencontrée ou lorsqu’il n’y a plus d’éléments.

Remarques

Si la valeur de la propriété ProviderName n’a pas été définie, la valeur par défaut (généralement le fournisseur de chiffrement de base Microsoft) de ProviderName , telle que définie dans le Registre, est utilisée.

Cette méthode est désactivée lorsque le contrôle d’inscription de certificat est exécuté en tant que contrôle scripté.

Exemples

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;
    }
}

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	xenroll.h
Bibliothèque	Uuid.lib
DLL	Xenroll.dll