Metodo ICEnroll3::GetAlgName (xenroll.h)

Articolo
03/13/2024

[Questo metodo non è più disponibile per l'uso a partire da Windows Server 2008 e Windows Vista.]

Il metodo GetAlgName recupera il nome di un algoritmo crittografico dato il relativo ID. I valori recuperati da questo metodo dipendono dal provider di servizi di crittografia corrente. Questo metodo è stato definito per la prima volta nell'interfaccia ICEnroll3 .

Sintassi

HRESULT GetAlgName(
  [in]  LONG algID,
  [out] BSTR *pbstr
);

Parametri

[in] algID

Valore che rappresenta un algoritmo crittografico, come definito in Wincrypt.h. Ad esempio, CALG_MD2 è un identificatore di algoritmo definito. Per avere esito positivo, il CSP corrente deve supportare l'algoritmo algID .

[out] pbstr

Al termine dell'operazione, un puntatore a un BSTR che rappresenta il nome dell'algoritmo specificato da algID. Al termine dell'uso della funzione BSTR, liberarla chiamando la funzione SysFreeString .

Valore restituito

C++

Il valore restituito è un HRESULT. Un valore di S_OK indica l'esito positivo. Se un CSP non supporta questo metodo o non supporta l'algoritmo di crittografia algID , viene restituito un errore.

VB

Il valore restituito è una stringa che rappresenta il nome dell'algoritmo specificato da algID. Se un CSP non supporta questo metodo, viene restituito un errore.

Commenti

Questo metodo può essere usato per visualizzare i nomi degli algoritmi i cui ID vengono recuperati chiamando EnumAlgs.

Le costanti per gli algoritmi crittografici sono definite in Wincrypt.h.

Esempio

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

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	xenroll.h
Libreria	Uuid.lib
DLL	Xenroll.dll