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

Статья
03/04/2024

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

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

Значения, полученные этим методом, зависят от текущего CSP.

Синтаксис

HRESULT GetSupportedKeySpec(
  [out] LONG *pdwKeySpec
);

Параметры

[out] pdwKeySpec

Указатель на long, получающий битовый флаг, указывающий, поддерживает ли текущий поставщик служб конфигурации ключи обмена и сигнатуры.

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

C++

Если метод завершается успешно, метод возвращает S_OK.

Если метод завершается сбоем, он возвращает значение HRESULT , указывающее на ошибку. Список распространенных кодов ошибок см. в разделе Общие значения HRESULT.

VB

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

Вызовите этот метод, чтобы определить, поддерживает ли текущий CSP ключи обмена, ключи подписи или и то, и другое. Параметр pdwKeySpec будет содержать одну или несколько следующих констант (определенных в Wincrypt.h):

AT_KEYEXCHANGE
AT_SIGNATURE

Примеры

DWORD dwKeySpec;

// Determine the supported key specifications.
// hr is HRESULT variable.
hr = pEnroll->GetSupportedKeySpec( &dwKeySpec );
if ( FAILED( hr ) )    
    printf("Failed GetSupportedKeySpec [%x]\n", hr);
else
{
    printf("Exchange keys are %s. Signature keys are %s.\n",
           dwKeySpec & AT_KEYEXCHANGE ? "supported" : "not supported",
           dwKeySpec & AT_SIGNATURE ? "supported" : "not supported" );
}

Требования

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