Metodo ICertManageModule::SetProperty (certmod.h)

Articolo
02/26/2024

Il metodo SetProperty consente a un modulo di impostare un valore della proprietà.

Sintassi

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

Parametri

[in] strConfig

Rappresenta la stringa di configurazione per il server Servizi certificati nel formato COMPUTERNAME\CANAME, dove COMPUTERNAME è il nome di rete del server Servizi certificati e CANAME è il nome comune dell'autorità di certificazione (CA) come immesso per la CA durante l'installazione di Servizi certificati. Per informazioni sul nome della stringa di configurazione, vedere ICertConfig.

[in] strStorageLocation

Percorso che fornisce l'archiviazione per i valori delle proprietà, come descritto nella definizione di strStorageLocation in ICertManageModule::GetProperty.

[in] strPropertyName

Nome della proprietà il cui valore viene assegnato. I moduli criteri e di uscita supportano le proprietà seguenti, usate da Certificate Services Manager.

Valore	Significato
Nome	Nome del modulo.
Descrizione	Descrizione del modulo.
Copyright	Copyright relativo al modulo.
Versione file	Versione del file del modulo.
Versione del prodotto	Versione del modulo.

[in] Flags

Questo parametro è riservato e deve essere impostato su zero.

[in] pvarProperty

Valore assegnato alla proprietà specificata da strPropertyName.

Valore restituito

VB

Se il metodo ha esito positivo, il metodo restituisce S_OK.

Se il metodo ha esito negativo, restituisce un valore HRESULT che indica l'errore. Per un elenco di codici di errore comuni, vedere Valori HRESULT comuni.

Commenti

Questo metodo è destinato alla funzionalità futura. È tuttavia necessaria un'implementazione minima per soddisfare i requisiti dell'interfaccia ICertManageModule .

Esempio

#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;
}

Requisiti

Requisito	Valore
Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	certmod.h (includere Certsrv.h)
Libreria	Certidl.lib