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

  • Artículo

El método SetCAProperty establece un valor de propiedad para la entidad de certificación (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 memoria 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, vea 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 se indexa el parámetro PropId , el índice de base cero que se usará al recuperar el valor de la propiedad. Si PropId no está indexado, se omite este valor.

[in] PropType

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

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

[in] pvarPropertyValue

C++ Puntero a un variant que especifica el valor de la propiedad.
VB Variant que especifica el valor de propiedad.

Valor devuelto

VB

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

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

Requisitos

Requisito Value
Cliente mínimo compatible No se admite ninguno
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado certadm.h (incluya Certsrv.h)
Library Certidl.lib
Archivo DLL Certadm.dll

Consulte también

ICertAdmin2

ICertAdmin2::GetCAProperty