Metodo ICertAdmin2::SetConfigEntry (certadm.h)

Articolo
08/22/2023

Il metodo SetConfigEntry imposta le informazioni di configurazione per un'autorità di certificazione (CA).

Sintassi

HRESULT SetConfigEntry(
  [in] const BSTR strConfig,
  [in] const BSTR strNodePath,
  [in] const BSTR strEntryName,
  [in] VARIANT    *pvarEntry
);

Parametri

[in] strConfig

Valore stringa che rappresenta una stringa di configurazione valida per la CA nel formato COMPUTERNAME\CANAME, dove COMPUTERNAME è il nome di rete del server Servizi certificati e CANAME è il nome comune della CA, come immesso durante l'installazione di Servizi certificati. Per informazioni sul nome della stringa di configurazione, vedere ICertConfig. Questo parametro può essere una stringa vuota, nel qual caso le informazioni di configurazione impostano le informazioni di configurazione non specifiche di una CA. Questo parametro non può essere NULL.

ImportanteSetConfigEntry non cancella la cache interna quando viene modificata la stringa di configurazione. Quando si modifica la stringa di configurazione per la CA, è necessario creare un'istanza di un nuovo oggetto ICertAdmin e chiamare di nuovo questo metodo con la nuova stringa di configurazione.

[in] strNodePath

Valore stringa che rappresenta il percorso del nodo per le informazioni di configurazione. Questo parametro può essere una stringa vuota, in cui la funzione recupera le informazioni di configurazione dal percorso identificato da strConfig. Questo parametro non può essere NULL.

[in] strEntryName

Valore stringa che rappresenta il nome della voce le cui informazioni sono state impostate. Questo valore può essere una stringa vuota, in cui la voce predefinita è la voce impostata. Questo parametro non può essere NULL.

[in] pvarEntry

C++	Puntatore a VARIANT che specifica le informazioni da impostare. Se questo valore è vuoto, la chiave indicata verrà eliminata.
VB	Variant che specifica le informazioni da impostare. Se questo valore è vuoto, la chiave indicata verrà eliminata.

Valore restituito

VB

Se la funzione ha esito positivo, il valore restituito è S_OK.

Se la funzione ha esito negativo, il valore restituito è un VALORE HRESULT che indica l'errore. Per un elenco di codici di errore comuni, vedere Valori HRESULT comuni.

Commenti

Le informazioni di configurazione vengono archiviate nel Registro di sistema nel percorso seguente.

HKEY_LOCAL_MACHINE\SISTEMA\Currentcontrolset\Servizi\CertSvc\Configurazione\[CASANITIZEDNAME]\[strNodePath]\[strEntryName]

Dove CASANITIZEDNAME è il nome sanificato per la CA. Per altre informazioni sui nomi sanificati, vedere ICertConfig2::GetConfig.

Requisiti


Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	certadm.h (include Certsrv.h)
Libreria	Certidl.lib
DLL	Certadm.dll

Vedi anche

ICertAdmin2

Condividi tramite