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

O método Initialize inicializa a propriedade da ID da 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 . Normalmente, a cadeia de caracteres de configuração é 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 . Normalmente, a cadeia de caracteres de configuração é 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 .

Valor de retorno

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 valores possíveis incluem, mas não se limitam a, aqueles na tabela a seguir. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT Comuns.

Observações

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:

• CADnsName
• CAName
• FriendlyName
• RequestId

Requirements

Consulte também

ICertProperty

ICertPropertyEnrollment