Método ICertPropertyEnrollment::Initialize (certenroll.h)

  • Artigo

O método Initialize inicializa a propriedade da ID de solicitação de certificado, da cadeia de caracteres de configuração da AC (autoridade de certificação) e de um nome de exibição de certificado opcional.

Sintaxe

HRESULT Initialize(
  [in]           LONG RequestId,
  [in]           BSTR strCADnsName,
  [in]           BSTR strCAName,
  [in, optional] BSTR strFriendlyName
);

Parâmetros

[in] RequestId

Uma variável LONG que contém a ID da solicitação de certificado. Uma ID de solicitação é criada pelo processo de registro. Você pode recuperar esse valor chamando a propriedade RequestId na interface IX509Enrollment .

[in] strCADnsName

Uma variável BSTR que contém o nome DNS (Sistema de Nomes de Domínio) da AC. Esse é o primeiro nome na cadeia de caracteres de configuração CADnsName\CAName . A cadeia de caracteres de configuração normalmente é definida durante o processo de registro. O nome DNS pode ser recuperado chamando a propriedade CAConfigString e separando a cadeia de caracteres em suas partes constituintes.

[in] strCAName

Uma variável BSTR que contém o CN (nome comum da entidade) da AC. Esse é o segundo nome na cadeia de caracteres de configuração CADnsName\CAName CA. A cadeia de caracteres de configuração normalmente é definida durante o processo de registro. O nome CN pode ser recuperado chamando a propriedade CAConfigString e separando a cadeia de caracteres em suas partes constituintes.

[in, optional] strFriendlyName

Uma variável BSTR que contém um nome de exibição opcional para o certificado. O valor padrão é NULL. Esse valor normalmente é definido durante o processo de registro. Você pode recuperá-lo chamando a propriedade CertificateFriendlyName .

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
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)
 O objeto já está inicializado.

Comentários

Os valores que você pode usar para inicializar o objeto ICertPropertyEnrollment são definidos durante o processo de registro de certificado quando o cliente chama o método Enroll no objeto IX509Enrollment . Ou seja, para recuperar uma ID de solicitação, chame a propriedade RequestId no objeto IX509Enrollment . Para recuperar um nome de exibição de certificado, chame a propriedade CertificateFriendlyName . Para recuperar um nome diferenciado e um nome comum, chame a propriedade CAConfigString e separe a cadeia de caracteres de configuração em suas partes constituintes.

Chame o método SetValueOnCertificate para associar a propriedade a um certificado. Você também pode chamar as seguintes propriedades para recuperar os valores especificados durante a inicialização:

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

ICertProperty

ICertPropertyEnrollment