Método ICertSrvSetup::SetCADistinguishedName (casetup.h)

El método SetCADistinguishedName establece un nombre común de entidad de certificación (CA) y un sufijo de nombre distintivo opcional.

Sintaxis

HRESULT SetCADistinguishedName(
  [in] const BSTR   bstrCADN,
  [in] VARIANT_BOOL bIgnoreUnicode,
  [in] VARIANT_BOOL bOverwriteExistingKey,
  [in] VARIANT_BOOL bOverwriteExistingCAInDS
);

Parámetros

[in] bstrCADN

Cadena que contiene el nombre de una ENTIDAD de certificación con el formato CommonName,DistinguishedNameSuffix, donde la coma (,) y DistinguishedNameSuffix son opcionales.

En la tabla siguiente se describe un ejemplo de un nombre distintivo, incluido el sufijo de nombre distintivo opcional, para el equipo MyServer.

Valor	Significado
CN=mydomain-MyServer-CA	Nombre común del equipo MyServer que pertenece al dominio MyDomain .
DC=MyDomain,DC=MyCompany,DC=com	Sufijo de nombre distintivo (opcional)
CN=MyDomain-MyServer-CA,DC=MyDomain,DC=MyCompany,DC=com	Nombre distintivo, incluido el sufijo opcional

[in] bIgnoreUnicode

Valor que indica si se va a permitir la codificación Unicode de la información de nombre. Un valor de VARIANT_TRUE habilita la codificación Unicode.

[in] bOverwriteExistingKey

Valor que indica si se va a permitir el nombre en bstrCADN, aunque exista una clave privada con el mismo nombre en el equipo. Un valor de VARIANT_TRUE permite al método sobrescribir la clave existente.

[in] bOverwriteExistingCAInDS

Valor que indica si se va a permitir el nombre en bstrCADN, aunque existe una ENTIDAD de certificación con el mismo nombre distintivo en el servicio de directorio. Un valor de VARIANT_TRUE permite que el método sobrescriba la entrada del servicio de directorio existente.

Valor devuelto

None

Observaciones

Si se ejecuta correctamente, el método SetCADistinguishedName cambia los valores de propiedad ENUM_SETUPPROP_CANAME y ENUM_SETUPPROP_CADSSUFFIX para reflejar el nombre bstrCADN . Para obtener más información sobre las propiedades de configuración, consulte CASetupProperty.

Tras un error, el método SetCADistinguishedName podría establecer información de error adicional en las propiedades CAErrorId y CAErrorString .

Si se usa una clave existente y su certificado asociado para configurar la ENTIDAD de certificación, no se debe llamar a este método. Si se usa una clave existente para configurar la ENTIDAD de certificación, sin usar el certificado asociado, el nombre común de bstrCADN debe coincidir con el ContainerNamesaneado de la clave.

Si bstrCADN incluye codificación UTF8, establezca la marca adecuada en CAPolicy.inf y colóquela en %windir%.

Requisitos

Requisito	Value
Cliente mínimo compatible	No se admite ninguno
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	casetup.h
Archivo DLL	Certocm.dll

Consulte también

ICertSrvSetup