Compartilhar via


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
Mssign32.dll