Enumerazione dei protocolli supportati

I protocolli e i pacchetti di crittografia supportati possono essere elencati dalle chiamate a CryptGetProvParam con PP_ENUMALGS o PP_ENUMALGS_EX. Il valore PP_ENUMALGS_EX funziona come PP_ENUMALGS, ma restituisce una struttura PROV_ENUMALGS_EX che contiene informazioni più estese sugli algoritmi supportati dal provider.

Per altre informazioni sui flag di protocollo definiti e sui relativi valori, vedere Flag di protocollo.

Dato che il membro hCryptProv è l'handle di un contesto di crittografia aperto acquisito tramite CryptAcquireContext con il relativo parametro dwProvType impostato su PROV_RSA_SCHANNEL, nell'esempio seguente vengono elencati i nomi di tutti gli algoritmi disponibili nel CSP.

PROV_ENUMALGS_EX EnumAlgs;     //   Structure to hold information on 
                               //   a supported algorithm
DWORD dFlag = CRYPT_FIRST;     //   Flag indicating that the first
                               //   supported algorithm is to be
                               //   enumerated. Changed to 0 after the
                               //   first call to the function.
cbData = sizeof(PROV_ENUMALGS_EX);

while( CryptGetProvParam(
    hCryptProv,          // handle to an open cryptographic provider
    PP_ENUMALGS_EX, 
    (BYTE *)&EnumAlgs,  // information on the next algorithm
    &cbData,            // number of bytes in the PROV_ENUMALGS_EX
    dFlag))             // flag to indicate whether this is a first or
                        // subsequent algorithm supported by the
                        // CSP.
{
    printf("Supported Algorithm name %s\n", EnumAlgs.szName);
    dFlag = CRYPT_NEXT;          // Set to CRYPT_NEXT after the first call,
} //  end of while loop. When all of the supported algorithms have
  //  been enumerated, the function returns FALSE.

Nella tabella seguente sono elencati alcuni algoritmi restituiti da un PROV_RSA_SCHANNEL CSP nazionale tipico. Si noti che in questo esempio la crittografia SSL2 SHA e SSL2 DES non è supportata dal CSP.

Identificatore dell'algoritmo	Lunghezza minima chiave	Lunghezza massima della chiave	Protocolli	Nome algoritmo
CALG_RSA_KEYX	512	2048	0x0007	"RSA_KEYX"
CALG_MD5	128	128	0x0007	"MD5"
CALG_SHA	160	160	0x0005	"SHA"
CALG_RC4	40	128	0x0007	"RC4"
CALG_DES	56	56	0x0005	"DES"

 

Per preparare l'invio di messaggi ClientHello o ServerHello, il motore di protocollo Schannel enumera gli algoritmi e le dimensioni delle chiavi supportate dal CSP e compila un elenco internamente dei pacchetti di crittografia supportati.