Metodo ICEnroll3::GetSupportedKeySpec (xenroll.h)

Articolo
03/04/2024

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

Il metodo GetSupportedKeySpec recupera informazioni relative al supporto CSP ( Cryptographic Service Provider ) corrente per le operazioni di firma e/o scambio. Questo metodo è stato definito per la prima volta nell'interfaccia ICEnroll3 .

I valori recuperati da questo metodo dipendono dal CSP corrente.

Sintassi

HRESULT GetSupportedKeySpec(
  [out] LONG *pdwKeySpec
);

Parametri

[out] pdwKeySpec

Puntatore a un valore LONG che riceve un flag di bit che indica se il provider di servizi di configurazione corrente supporta chiavi di scambio e firma.

Valore restituito

C++

Se il metodo ha esito positivo, il metodo restituisce S_OK.

Se il metodo ha esito negativo, restituisce un valore HRESULT che indica l'errore. Per un elenco dei codici di errore comuni, vedere Valori HRESULT comuni.

VB

Restituisce un valore che indica se il CSP corrente supporta chiavi di scambio e firma. Se il provider di servizi di configurazione non supporta questo metodo, viene restituito un errore.

Commenti

Chiamare questo metodo per determinare se il provider di servizi di configurazione corrente supporta chiavi di scambio, chiavi di firma o entrambi. Il parametro pdwKeySpec conterrà una o più delle costanti seguenti (definite in Wincrypt.h):

AT_KEYEXCHANGE
AT_SIGNATURE

Esempio

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

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