Compartir a través de


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

El método Initialize inicializa el objeto a partir del nombre para mostrar del certificado. Este método está habilitado para web.

Sintaxis

HRESULT Initialize(
  [in] BSTR strFriendlyName
);

Parámetros

[in] strFriendlyName

Variable BSTR que contiene el nombre. La longitud de la cadena no puede superar los 260 caracteres.

Valor devuelto

Si la función se realiza correctamente, la función devuelve S_OK.

Si se produce un error en la función, devuelve un valor HRESULT que indica el error. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.

Código o valor devuelto Descripción
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)
El objeto ya se ha inicializado.
HRESULT_FROM_WIN32(ERROR_FILENAME_EXCED_RANGE)
La longitud de la cadena supera los 260 caracteres.

Comentarios

Normalmente, se especifica el nombre para mostrar en una interfaz de usuario o desde la línea de comandos antes de comenzar el proceso de inscripción para que el nombre pueda asociarse con el certificado ficticio en el almacén de solicitudes. Para recuperar ese valor y usarlo aquí, llame a CertificateFriendlyName en la interfaz IX509Enrollment .

Llame al método SetValueOnCertificate para asociar la propiedad a un certificado. Llame a la propiedad FriendlyName para recuperar el nombre para mostrar.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado certenroll.h
Archivo DLL CertEnroll.dll

Consulte también

ICertProperties

ICertProperty

ICertPropertyDescription

ICertPropertyFriendlyName