Metodo ICertAdmin2::SetCAProperty (certadm.h)

  • Articolo

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 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.

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 è indicizzato, questo valore viene ignorato.

[in] PropType

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

Valore Significato
PROPTYPE_LONG
 Dati 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 valore VARIANT che specifica il valore della proprietà.
VB Valore 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 valore HRESULT che indica l'errore. Per un elenco dei codici di errore comuni, vedere Valori HRESULT comuni.

Requisiti

Requisito Valore
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

ICertAdmin2::GetCAProperty