Método IX509AttributeClientId::InitializeEncode (certenroll.h)

El método InitializeEncode inicializa el atributo a partir de información sobre el usuario, el equipo cliente y la aplicación que enviaron la solicitud de certificado.

Sintaxis

HRESULT InitializeEncode(
  [in]           RequestClientInfoClientId ClientId,
  [in, optional] BSTR                      strMachineDnsName,
  [in, optional] BSTR                      strUserSamName,
  [in, optional] BSTR                      strProcessName
);

Parámetros

[in] ClientId

Valor de enumeración RequestClientInfoClientId que identifica el tipo de aplicación que creó la solicitud. Algunos ejemplos son los servicios de inscripción automática, las herramientas de solicitud de línea de comandos y las aplicaciones de solicitud personalizadas.

[in, optional] strMachineDnsName

Variable BSTR que contiene el nombre del sistema de nombres de dominio (DNS) del equipo en el que se creó la solicitud, por ejemplo ComputerName.contoso.com. Si no proporciona un nombre, el método llama a la función GetComputerNameEx . Si no se encuentra un nombre, se produce un error en el método.

[in, optional] strUserSamName

Variable BSTR que contiene el nombre del Administrador de cuentas de seguridad (SAM) para el usuario con el formato DomainName\UserName. Si no proporciona un nombre, el método llama a la función GetUserNameEx . Si no se encuentra un nombre, se produce un error en el método.

[in, optional] strProcessName

Variable BSTR que contiene el nombre de la aplicación que creó la solicitud de certificado. Si no proporciona un nombre, el método llama a la función GetCommandLine y analiza la línea de comandos. Si no se encuentra un nombre, se produce un error en el método.

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. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.

Comentarios

El identificador de objeto (OID) de este atributo es XCN_OID_REQUEST_CLIENT_INFO (1.3.6.1.4.1.311.21.20). Para obtener más información, consulte CERTENROLL_OBJECTID. El atributo se crea como una estructura de notación de sintaxis abstracta (ASN.1) codificada mediante reglas de codificación distinguida (DER).

Debe llamar a InitializeEncode o InitializeDecode para poder usar un objeto IX509AttributeClientId . Los dos métodos se complementan entre sí. El método InitializeEncode permite construir una estructura ASN.1 codificada a partir de datos sin procesar y el método InitializeDecode permite inicializar datos sin procesar a partir de una estructura ASN.1 codificada. Puede llamar a las siguientes propiedades para recuperar los datos sin procesar:

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

IX509AttributeClientId

InitializeDecode