Compartir a través de

Método ICertAdmin2::SetCAProperty (certadm.h)

  • Artículo

El método SetCAProperty establece un valor de propiedad para la entidad de certificación de (CA).

Sintaxis

HRESULT SetCAProperty(
  [in] const BSTR strConfig,
  [in] LONG       PropId,
  [in] LONG       PropIndex,
  [in] LONG       PropType,
  [in] VARIANT    *pvarPropertyValue
);

Parámetros

[in] strConfig

Valor de cadena que representa una cadena de configuración válida para la ENTIDAD de certificación con el formato COMPUTERNAME\CANAME, donde COMPUTERNAME es el nombre de red del servidor de Servicios de certificados y CANAME es el nombre común de la ENTIDAD de certificación, tal como se especifica durante la instalación de Servicios de certificados. Para obtener información sobre el nombre de la cadena de configuración, vea ICertConfig.

ImportanteSetCAProperty no borra la caché interna cuando se cambia la cadena de configuración. Al cambiar la cadena de configuración de la ENTIDAD de certificación, debe crear una instancia de un nuevo objeto ICertAdmin y llamar a este método de nuevo con la nueva cadena de configuración.

 

[in] PropId

Especifica uno de los siguientes identificadores de propiedad.

Para obtener información sobre todas las propiedades de ca, incluidas las que son de solo lectura, consulte ICertAdmin2::GetCAProperty.

Valor Significado
CR_PROP_KRACERT
 Certificado del agente de recuperación de claves (KRA) de la ENTIDAD de certificación.

Formato de datos: binario, indexado.
CR_PROP_KRACERTCOUNT
 Número de certificados KRA para la ENTIDAD de certificación.

Formato de datos: long.
CR_PROP_KRACERTUSEDCOUNT
 Número de certificados KRA usados por la ENTIDAD de certificación.

Formato de datos: long.
CR_PROP_ROLESEPARATIONENABLED
 Valor que especifica si la separación de roles está habilitada.

Formato de datos: long.
CR_PROP_TEMPLATES
 Lista de plantillas admitidas por la ENTIDAD de certificación.

Formato de datos: cadena.

[in] PropIndex

Si el parámetro PropId está indexado, el índice de base cero que se usará al recuperar el valor de propiedad. Si PropId no está indexado, este valor se omite.

[in] PropType

Especifica el tipo de la propiedad . Este parámetro puede ser uno de los siguientes valores.

Valor Significado
PROPTYPE_LONG
 Datos de long firmados.
PROPTYPE_DATE
 Fecha y hora (reservada para uso futuro).
PROPTYPE_BINARY
 Datos binarios.
PROPTYPE_STRING
 datos de cadenaUnicode.

[in] pvarPropertyValue

de C++ Puntero a un VARIANT que especifica el valor de propiedad.
vb Un Variant que especifica el valor de propiedad.

Valor devuelto

VB

Si la función se ejecuta correctamente, se S_OK el valor devuelto.

Si se produce un error en la función, el valor devuelto es un HRESULT que indica el error. Para obtener una lista de códigos de error comunes, vea valores HRESULT comunes.

Requisitos

Requisito Valor
cliente mínimo admitido No se admite ninguna
servidor mínimo admitido Windows Server 2003 [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
encabezado de certadm.h (incluya Certsrv.h)
biblioteca de Certidl.lib
DLL de Certadm.dll

Consulte también

ICertAdmin2

ICertAdmin2::GetCAProperty