Método ICertPropertyFriendlyName::Initialize (certenroll.h)
O método Initialize inicializa o objeto do nome de exibição do certificado. Esse método está habilitado para a Web.
Sintaxe
HRESULT Initialize(
[in] BSTR strFriendlyName
);
Parâmetros
[in] strFriendlyName
Uma variável BSTR que contém o nome. O comprimento da cadeia de caracteres não pode exceder 260 caracteres.
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. |
|
O comprimento da cadeia de caracteres excede 260 caracteres. |
Comentários
Normalmente, você especifica o nome de exibição em uma interface do usuário ou na linha de comando antes de iniciar o processo de registro para que o nome possa ser associado ao certificado fictício no repositório de solicitações. Para recuperar esse valor e usá-lo aqui, chame CertificateFriendlyName na interface IX509Enrollment .
Chame o método SetValueOnCertificate para associar a propriedade a um certificado. Chame a propriedade FriendlyName para recuperar o nome de exibiçã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 |