Enumerando protocolos com suporte

Os protocolos e conjuntos de criptografia com suporte podem ser listados por chamadas para CryptGetProvParam com PP_ENUMALGS ou PP_ENUMALGS_EX. O valor de PP_ENUMALGS_EX funciona como PP_ENUMALGS, mas retorna uma estrutura PROV_ENUMALGS_EX que contém informações mais abrangentes sobre os algoritmos compatíveis com o provedor.

Para obter mais informações sobre sinalizadores de protocolo definidos e seus valores, consulte Sinalizadores de protocolo.

Considerando que o membro hCryptProv é o identificador de um contexto criptográfico aberto adquirido usando CryptAcquireContext com seu parâmetro dwProvType definido como PROV_RSA_SCHANNEL, o exemplo a seguir lista os nomes de todos os algoritmos disponíveis no 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.

A tabela a seguir lista alguns algoritmos retornados por um CSP de PROV_RSA_SCHANNEL doméstico típico. Observe que nem a criptografia SSL2 SHA MACs nem SSL2 DES tem suporte do CSP neste exemplo.

Para se preparar para enviar mensagens ClientHello ou ServerHello, o mecanismo de protocolo Schannel enumera os algoritmos e os tamanhos de chave compatíveis com o CSP e cria uma lista internamente de pacotes de criptografia com suporte.