Metodo ICertAdmin2::SetCAProperty (certadm.h)

Articolo
07/16/2024

Il metodo SetCAProperty imposta un valore della proprietà per l'autorità di certificazione (CA).

Sintassi

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

Parametri

[in] strConfig

Valore stringa che rappresenta una stringa di configurazione valida per la CA nel formato NOMECOMPUTER\CANAME, dove NOMECOMPUTER è 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.

importanteSetCAProperty 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] PropId

Specifica uno degli identificatori di proprietà seguenti.

Per informazioni su tutte le proprietà della CA, incluse quelle di sola lettura, vedere ICertAdmin2::GetCAProperty.

Valore	Significato
CR_PROP_KRACERT	Certificato dell'agente di ripristino delle chiavi (KRA) della CA. Formato dati: binario, indicizzato.
CR_PROP_KRACERTCOUNT	Numero di certificati KRA per la CA. Formato dati: Long.
CR_PROP_KRACERTUSEDCOUNT	Numero di certificati KRA usati dalla CA. Formato dati: Long.
CR_PROP_ROLESEPARATIONENABLED	Valore che specifica se la separazione dei ruoli è abilitata. Formato dati: Long.
CR_PROP_TEMPLATES	Elenco di modelli supportati dalla CA. Formato dati: stringa.

[in] PropIndex

Se il parametro PropId viene indicizzato, l'indice in base zero da utilizzare durante il recupero del valore della proprietà. Se PropId non viene indicizzato, questo valore viene ignorato.

[in] PropType

Specifica il tipo della proprietà. Questo parametro può essere uno dei valori seguenti.

Valore	Significato
PROPTYPE_LONG	Dati di Long firmati.
PROPTYPE_DATE	Data/ora (riservata per uso futuro).
PROPTYPE_BINARY	Dati binari.
PROPTYPE_STRING	dati stringa Unicode.

[in] pvarPropertyValue

C++	Puntatore a un VARIANT che specifica il valore della proprietà.
VB	Variant che specifica il valore della proprietà.

Valore restituito

VB

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

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

Fabbisogno

Requisito	Valore
client minimo supportato	Nessuna supportata
server minimo supportato	Windows Server 2003 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	certadm.h (include Certsrv.h)
libreria	Certidl.lib
dll	Certadm.dll

Vedere anche

ICertAdmin2

ICertAdmin2::GetCAProperty

Condividi tramite