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