Método ICertPropertyEnrollment::Initialize (certenroll.h)
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 |
|---|---|
|
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 |