Criando a nova funcionalidade

As seguintes funções estão entre as funções CryptoAPI que podem ser estendidas.

Em uso normal com um OID existente e tipo de codificação, o código na função CryptoAPI, em si, é usado. Se uma dessas funções é chamada com um OID e tipo de codificação que o código na função CryptoAPI não foi projetado para manipular, uma nova função, contendo a nova funcionalidade, deve ser criada em uma DLL. Essa DLL deve ser registrada no registro ou instalada na memória.

Quando uma das funções listadas é chamada com o tipo de codificação e OID recém-designado, o código na nova DLL é usado em vez do código fornecido como parte da função CryptoAPI.

O nome da função recém-desenvolvida pode ser o nome listado em "OID function name string" na tabela anterior ou um nome diferente pode ser dado quando o novo código de função é registrado.

A nova função deve utilizar um protótipo adequado. Em todos os casos, exceto para CertOpenStore, este protótipo é o mesmo que a função CryptoAPI que chama a nova função. No caso de CertOpenStore o protótipo é o seguinte.

#include <windows.h>

BOOL WINAPI CertDllOpenStoreProv(
  IN LPCSTR lpszStoreProvider,
  IN DWORD dwEncodingType,
  IN HCRYPTPROV hCryptProv,
  IN DWORD dwFlags,
  IN const void *pvPara,
  IN HCERTSTORE hCertStore,
  IN OUT PCERT_STORE_PROV_INFO pStoreProvInfo
);

Além de fornecer o código para a nova função em uma DLL, estender a funcionalidade de CryptEncodeObject ou CryptDecodeObject requer uma definição de tipo para a nova estrutura de dados C a ser colocada em um arquivo de cabeçalho incluído quando o programa do usuário é compilado.