Método ICEnroll3::GetSupportedKeySpec (xenroll.h)

[Esse método não está mais disponível para uso a partir do Windows Server 2008 e do Windows Vista.]

O método GetSupportedKeySpec recupera informações sobre o suporte atual do CSP ( provedor de serviços criptográficos ) para operações de assinatura e/ou troca. Esse método foi definido pela primeira vez na interface ICEnroll3 .

Os valores recuperados por esse método dependem do CSP atual.

Sintaxe

HRESULT GetSupportedKeySpec(
  [out] LONG *pdwKeySpec
);

Parâmetros

[out] pdwKeySpec

Um ponteiro para um LONG que recebe um sinalizador de bits que indica se o CSP atual dá suporte a chaves de troca e assinatura.

Retornar valor

C++

Se o método for bem-sucedido, o método retornará S_OK.

Se o método falhar, ele retornará um valor HRESULT que indica o erro. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT comuns.

VB

Retorna um valor que indica se o CSP atual dá suporte à troca e às chaves de assinatura. Se o CSP não der suporte a esse método, um erro será retornado.

Comentários

Chame esse método para determinar se o CSP atual dá suporte a chaves de troca, chaves de assinatura ou ambos. O parâmetro pdwKeySpec conterá uma ou mais das seguintes constantes (definidas em Wincrypt.h):

  • AT_KEYEXCHANGE
  • AT_SIGNATURE

Exemplos

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

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho xenroll.h
Biblioteca Uuid.lib
DLL Xenroll.dll

Confira também

CEnroll

ICEnroll3

ICEnroll4