IcEnroll3 ::GetAlgName, méthode (xenroll.h)
[Cette méthode n’est plus disponible à partir de Windows Server 2008 et Windows Vista.]
La méthode GetAlgName récupère le nom d’un algorithme de chiffrement en fonction de son ID. Les valeurs récupérées par cette méthode dépendent du fournisseur de services de chiffrement (CSP) actuel. Cette méthode a d’abord été définie dans l’interface ICEnroll3 .
Syntaxe
HRESULT GetAlgName(
[in] LONG algID,
[out] BSTR *pbstr
);
Paramètres
[in] algID
Valeur qui représente un algorithme de chiffrement, tel que défini dans Wincrypt.h. Par exemple, CALG_MD2 est un identificateur d’algorithme défini. Pour que cette méthode réussisse, le fournisseur csp actuel doit prendre en charge l’algorithme algID .
[out] pbstr
En cas de réussite, pointeur vers un BSTR qui représente le nom de l’algorithme spécifié par algID. 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. Si un fournisseur de solutions Cloud ne prend pas en charge cette méthode ou ne prend pas en charge l’algorithme de chiffrement algID , une erreur est retournée.VB
La valeur de retour est une chaîne qui représente le nom de l’algorithme spécifié par algID. Si un fournisseur de solutions Cloud ne prend pas en charge cette méthode, une erreur est retournée.Remarques
Cette méthode peut être utilisée pour afficher les noms des algorithmes dont les ID sont récupérés en appelant EnumAlgs.
Les constantes des algorithmes de chiffrement sont définies dans Wincrypt.h.
Exemples
BSTR bstrAlgName = NULL;
HRESULT hr;
// Retrieve the algorithm name.
// dwAlgID is a DWORD variable for an algorithm ID.
hr = pEnroll->GetAlgName( dwAlgID, &bstrAlgName);
if (FAILED(hr))
printf("Failed GetAlgName [%x]\n", hr);
else
printf("AlgID: %d Name: %S\n", dwAlgID, bstrAlgName );
// Free BSTR resource.
if ( NULL != bstrAlgName )
{
SysFreeString( bstrAlgName );
bstrAlgName = 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 |