Método ICertManageModule::SetProperty (certmod.h)

Artículo
02/23/2024

El método SetProperty permite a un módulo establecer un valor de propiedad.

Sintaxis

HRESULT SetProperty(
  [in] const BSTR    strConfig,
  [in] BSTR          strStorageLocation,
  [in] BSTR          strPropertyName,
  [in] LONG          Flags,
  [in] const VARIANT *pvarProperty
);

Parámetros

[in] strConfig

Representa la cadena de configuración del servidor de Servicios de certificados 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 (CA) tal como se especifica para la CA durante la instalación de Servicios de certificados. Para obtener información sobre el nombre de la cadena de configuración, vea ICertConfig.

[in] strStorageLocation

Ubicación que proporciona almacenamiento para los valores de propiedad, como se describe en la definición de strStorageLocation en ICertManageModule::GetProperty.

[in] strPropertyName

Nombre de la propiedad cuyo valor se va a asignar. Los módulos de directiva y salida deben admitir las siguientes propiedades, que el Administrador de servicios de certificados usa.

Valor	Significado
Nombre	Nombre del módulo.
Descripción	Descripción del módulo.
Copyright	Derechos de autor relacionados con el módulo.
Versión del archivo	Versión del archivo del módulo.
Versión del producto	Versión del módulo.

[in] Flags

Este parámetro está reservado y debe establecerse en cero.

[in] pvarProperty

Valor que se asigna a la propiedad especificada por strPropertyName.

Valor devuelto

VB

Si el método se realiza correctamente, el método devuelve S_OK.

Si se produce un error en el método, devuelve un valor HRESULT que indica el error. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.

Comentarios

Este método está pensado para una funcionalidad futura. Sin embargo, se requiere una implementación mínima para cumplir los requisitos de la interfaz ICertManageModule .

Ejemplos

#include <windows.h>
#include <Certmod.h>

HRESULT CCertManagePolicyModule::SetProperty(
            /* [in] */ const BSTR strConfig,
            /* [in] */ BSTR strStorageLocation,
            /* [in] */ BSTR strPropertyName,
            /* [in] */ LONG Flags,
            /* [in] */ const VARIANT *pvarProperty)
{
    // This implementation fulfills the minimal requirement
    // needed for ICertManageModule::SetProperty.
    return S_OK;
}

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	certmod.h (incluye Certsrv.h)
Library	Certidl.lib