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

Confira também

ICertProperties

ICertProperty

ICertPropertyDescription

ICertPropertyFriendlyName