Função GetCryptProvFromCert
Importante
Essa API está preterida. A Microsoft pode remover essa API em versões futuras.
A função GetCryptProvFromCert obtém um identificador para um CSP ( provedor de serviços criptográficos ) e uma especificação de chave para um contexto de certificado . Use essa função para obter acesso à chave privada do emissor do certificado.
Observação
Essa função não tem nenhum arquivo de cabeçalho associado ou biblioteca de importação. Para chamar essa função, você deve criar um arquivo de cabeçalho definido pelo usuário e usar as funções LoadLibrary e GetProcAddress para vincular dinamicamente a Mssign32.dll.
Sintaxe
BOOL WINAPI GetCryptProvFromCert(
_In_ HWND hwnd,
_In_ PCCERT_CONTEXT pCert,
_Out_ HCRYPTPROV *phCryptProv,
_Out_ DWORD *pdwKeySpec,
_In_ BOOL *pfDidCryptAcquire,
_Out_opt_ LPWSTR *ppwszTmpContainer,
_Out_opt_ LPWSTR *ppwszProviderName,
_Out_ DWORD *pdwProviderType
);
Parâmetros
-
hwnd [in]
-
O identificador da janela a ser usada como o proprietário de todas as caixas de diálogo exibidas. Este membro não é usado no momento e é ignorado. É seguro passar NULL para esse parâmetro.
-
pCert [in]
-
Um ponteiro para uma estrutura CERT_CONTEXT para o certificado.
-
phCryptProv [out]
-
Um ponteiro para uma estrutura HCRYPTPROV que é um identificador para o CSP.
-
pdwKeySpec [out]
-
A especificação da chave privada a ser recuperada. Os valores possíveis incluem AT_KEYEXCHANGE ou AT_SIGNATURE.
-
pfDidCryptAcquire [in]
-
Um valor que especifica se a função adquiriu o identificador do provedor com base no certificado.
-
ppwszTmpContainer [out, opcional]
-
O endereço de um ponteiro para uma cadeia de caracteres terminada em nulo para o nome temporário do contêiner de chave. A função GetCryptProvFromCert fornece e inicializa o contêiner temporário. Ao chamar GetCryptProvFromCert, o endereço deve apontar para um valor NULL .
-
ppwszProviderName [out, opcional]
-
O endereço de um ponteiro para uma cadeia de caracteres terminada em nulo para o nome do provedor. A função GetCryptProvFromCert retorna o nome do provedor. Ao chamar GetCryptProvFromCert, o endereço deve apontar para um valor NULL .
-
pdwProviderType [out]
-
Especifica o tipo CSP. Isso pode ser zero ou um dos tipos de provedor criptográfico. Se esse membro for zero, o contêiner de chave será um dos provedores de armazenamento de chaves CNG.
Valor retornado
Após o sucesso, essa função retorna TRUE. A função GetCryptProvFromCert retornará FALSE se falhar.
Comentários
A ferramenta MakeCert chama GetCryptProvFromCert quando você a invoca usando a opção de linha de comando -is .
Se o parâmetro pfDidCryptAcquire for definido como TRUE, a função definirá os parâmetros phCryptProv, pdwKeySpec e pdwProviderType para os valores do provedor.
Quando terminar de usar o CSP, libere-o chamando a função FreeCryptProvFromCert .
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] |
| DLL |
|