Função PvkGetCryptProv
Importante
Essa API está preterida. A Microsoft pode remover essa API em versões futuras.
A função PvkGetCryptProv obtém um identificador para um CSP ( provedor de serviços criptográficos ) com base em um arquivo de chave privada ou em um nome de contêiner de chave.
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
HRESULT WINAPI PvkGetCryptProv(
_In_ HWND hwnd,
_In_ LPCWSTR pwszCaption,
_In_ LPCWSTR pwszCapiProvider,
_In_ DWORD dwProviderType,
_In_ LPCWSTR pwszPvkFile,
_In_ LPCWSTR pwszKeyContainerName,
_Out_ DWORD *pdwKeySpec,
_Out_opt_ LPWSTR *ppwszTmpContainer,
_Out_ HCRYPTPROV *phCryptProv
);
Parâmetros
-
hwnd [in]
-
Se uma senha for necessária para descriptografar o arquivo de chave privada, esse parâmetro será um identificador para o pai da caixa de diálogo senha; caso contrário, ele é NULL.
-
pwszCaption [in]
-
Um ponteiro para uma cadeia de caracteres terminada em nulo para a caixa de diálogo legenda.
-
pwszCapiProvider [in]
-
Um ponteiro para uma cadeia de caracteres terminada em nulo para o nome CSP.
-
dwProviderType [in]
-
Um valor DWORD que representa o tipo de provedor criptográfico. Para obter mais informações, consulte Tipos de provedor criptográfico.
-
pwszPvkFile [in]
-
Um ponteiro para uma cadeia de caracteres terminada em nulo que contém o nome de um arquivo de chave privada.
-
pwszKeyContainerName [in]
-
Um ponteiro para uma cadeia de caracteres terminada em nulo para o nome do contêiner de chave privada.
-
pdwKeySpec [out]
-
Um ponteiro para um valor DWORD para o tipo de chave do contêiner retornado com phCryptProv e ppwszTmpContainer.
-
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 PvkGetCryptProv fornece e inicializa o contêiner temporário. Ao chamar PvkGetCryptProv, o endereço deve apontar para um valor NULL .
-
phCryptProv [out]
-
Um ponteiro para um identificador para o CSP.
Valor retornado
Se o método for bem-sucedido, ele retornará S_OK.
Se o método falhar, ele retornará um valor HRESULT que indica o erro. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT comuns.
Comentários
A função PvkGetCryptProv primeiro tenta obter o identificador do provedor do nome do contêiner de chave especificado pelo parâmetro pwszKeyContainerName . Se você passar NULL para o parâmetro pwszKeyContainerName , PvkGetCryptProv tentará obter o provedor do arquivo de chave privada especificado no parâmetro pwszPvkFile .
Quando terminar de usar o CSP, libere o identificador do provedor e o contêiner de chaves temporárias chamando a função PvkFreeCryptProv .
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 |
|