IcEnroll3 ::GetAlgName, méthode (xenroll.h)

Article
03/13/2024

[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