Share via

Método IX509PrivateKey::Verify (certenroll.h)

  • Artigo

O método Verify verifica se uma chave privada existe e pode ser usada pelo cliente, mas não abre a chave.

Sintaxe

HRESULT Verify(
  [in] X509PrivateKeyVerify VerifyType
);

Parâmetros

[in] VerifyType

Um valor de enumeração X509PrivateKeyVerify que especifica opções de execução para o método. Esse pode ser um dos valores a seguir.

Valor Significado
VerifyNone
 Não verifica.
VerifySilent
 Não verifica se uma interface do usuário é necessária para abrir a chave privada; caso contrário, ocorrerá a verificação. Para obter mais informações, consulte Comentários.
VerifySmartCardNone
 Não verifica se a chave está armazenada em um cartão inteligente; caso contrário, esse valor é equivalente a VerifyAllowUI.
VerifySmartCardSilent
 Não verifica se uma interface do usuário é necessária para abrir a chave privada e se a chave está armazenada em um cartão inteligente; caso contrário, esse valor é equivalente a VerifyAllowUI. Para obter mais informações, consulte Comentários.
VerifyAllowUI
 O método permite que uma interface do usuário seja exibida.

Retornar valor

Se a função for bem-sucedida, a função retornará S_OK.

Se a função falhar, ela retornará um valor HRESULT que indica o erro. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir. Além disso, esse método chama as funções CryptGetUserKey e CryptAcquireContext CryptoAPI e pode retornar erros identificados nessa documentação. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT comuns.

Código de retorno Descrição
CERTSRV_E_PROPERTY_EMPTY
 Propriedades relacionadas ao CSP ou KSP não foram encontradas.

Comentários

Se os valores VerifySilent ou VerifySmartCardSilent forem definidos e o provedor criptográfico especificar que uma interface do usuário é necessária, a chave não será aberta, mas o método retornará S_OK.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho certenroll.h
DLL CertEnroll.dll

Confira também

IX509PrivateKey