Метод ICEnroll3::GetAlgName (xenroll.h)

Статья
03/13/2024

[Этот метод больше недоступен для использования в Windows Server 2008 и Windows Vista.]

Метод GetAlgName получает имя криптографического алгоритма по его идентификатору. Значения, полученные этим методом, зависят от текущего поставщика служб шифрования (CSP). Этот метод был впервые определен в интерфейсе ICEnroll3 .

Синтаксис

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

Параметры

[in] algID

Значение , представляющее алгоритм шифрования, как определено в Wincrypt.h. Например, CALG_MD2 является определенным идентификатором алгоритма. Для успешного выполнения этого метода текущий CSP должен поддерживать алгоритм algID .

[out] pbstr

При успешном выполнении — указатель на BSTR , представляющий имя алгоритма, указанного algID. Завершив использование BSTR, освободите его, вызвав функцию SysFreeString .

Возвращаемое значение

C++

Возвращаемое значение — HRESULT. Значение S_OK указывает на успешное выполнение. Если поставщик служб конфигурации не поддерживает этот метод или не поддерживает алгоритм шифрования algID , возвращается ошибка.

VB

Возвращаемое значение представляет собой строку, представляющую имя алгоритма, указанного algID. Если поставщик служб конфигурации не поддерживает этот метод, возвращается ошибка.

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

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	xenroll.h
Библиотека	Uuid.lib
DLL	Xenroll.dll