Método ICertProperty::RemoveFromCertificate (certenroll.h)

Artigo
03/05/2024

O método RemoveFromCertificate desassocia uma propriedade de um certificado. Especifique a propriedade a ser removida chamando a propriedade PropertyId .

Sintaxe

HRESULT RemoveFromCertificate(
  [in] VARIANT_BOOL MachineContext,
  [in] EncodingType Encoding,
  [in] BSTR         strCertificate
);

Parâmetros

[in] MachineContext

Um valor VARIANT_BOOL que indica se o repositório de certificados está localizado no computador local. Especifique VARIANT_TRUE se o repositório for local.

[in] Encoding

Um valor de enumeração EncodingType que especifica o tipo de codificação aplicado à cadeia de caracteres de certificado identificada pelo parâmetro strCertificate .

[in] strCertificate

Uma variável BSTR que contém o certificado codificado em DER.

A partir do Windows 7 e do Windows Server 2008 R2, você pode especificar uma impressão digital do certificado ou um número de série em vez de um certificado codificado. Isso faz com que a função pesquise os repositórios locais apropriados para o certificado correspondente. Tenha em mente os seguintes pontos:

O BSTR deve ser um número par de dígitos hexadecimal.
O espaço em branco entre pares hexadecimal é ignorado.
O parâmetro Encoding deve ser definido como XCN_CRYPT_STRING_HEXRAW.
O parâmetro MachineContext determina se o usuário ou o computador armazena ou ambos são pesquisados.
Se uma chave privada for necessária, somente os repositórios pessoais e de solicitação serão pesquisados.
Se uma chave privada não for necessária, os repositórios de AC raiz e intermediária também serão pesquisados.

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. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT comuns.

Valor/código retornado	Descrição
CRYPT_E_NOT_FOUND	Não foi possível encontrar o certificado.
CRYPT_E_UNEXPECTED_MSG_TYPE	O certificado foi encontrado, mas a chave privada não pôde ser carregada.

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

ICertProperties

ICertProperty

Compartilhar via