Metodo IOCSPAdmin::GetConfiguration (certadm.h)
Il metodo GetConfiguration si connette a un server di risposta OCSP (Online Certificate Status Protocol) e inizializza un oggetto OCSPAdmin con le informazioni di configurazione dal server.
Sintassi
HRESULT GetConfiguration(
[in] const BSTR bstrServerName,
[in] VARIANT_BOOL bForce
);
Parametri
[in] bstrServerName
Stringa contenente il nome del server risponditore.
[in] bForce
C++ | VARIANT_TRUE se il chiamante desidera leggere la configurazione del risponditore dal Registro di sistema del server quando non è possibile trovare un'istanza in esecuzione del servizio risponditore OCSP; in caso contrario, VARIANT_FALSE. |
VB | True se il chiamante desidera leggere la configurazione del risponditore dal Registro di sistema del server quando non è possibile trovare un'istanza in esecuzione del servizio risponditore OCSP; in caso contrario, False. |
Valore restituito
VB
Se il metodo ha esito positivo, restituisce S_OK.Se il metodo ha esito negativo, restituisce un valore HRESULT che indica l'errore. Per un elenco dei codici di errore comuni, vedere Valori HRESULT comuni.
Se il metodo restituisce HRESULT_FROM_WIN32(ERROR_INVALID_STATE),la configurazione è già inizializzata.
Se il metodo restituisce E_INVALIDARG, il parametro pVal è stato impostato su NULL.
Commenti
Nella tabella seguente sono elencati gli effetti del valore del parametro bForce nella chiamata al metodo.
Servizio risponditore OCSP nel server di destinazione | bForce è VARIANT_TRUE | bForce è VARIANT_FALSE |
---|---|---|
In esecuzione | Recuperare la configurazione dal servizio. | Recuperare la configurazione dal servizio. |
Arrestato | Tentare di recuperare la configurazione dal Registro di sistema del server. Se questo tentativo non riesce, restituisce un errore. | Restituisce un errore. |
Nella tabella seguente sono elencati gli effetti del valore del parametro bForce nella chiamata al metodo.
Servizio risponditore OCSP nel server di destinazione | bForce è True | bForce è False |
---|---|---|
In esecuzione | Recuperare la configurazione dal servizio. | Recuperare la configurazione dal servizio. |
Arrestato | Tentare di recuperare la configurazione dal Registro di sistema del server. Se questo tentativo non riesce, restituisce un errore. | Restituisce un errore. |
Questo metodo tenta di leggere la configurazione da un'istanza in esecuzione di un servizio risponditore OCSP, ma potrebbe non essere possibile se il servizio non è in esecuzione o è inaccessibile. Il chiamante può indicare al metodo di leggere la configurazione dal Registro di sistema del server se non è possibile trovare un'istanza in esecuzione.
Il metodo ha esito negativo se si tenta di chiamarlo più volte per un determinato oggetto OCSPAdmin . Ogni istanza di OCSPAdmin corrisponde a un server risponditore. Per connettersi a un altro server in una matrice di server risponditore OCSP, creare una nuova istanza di un oggetto OCSPAdmin .
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Nessuno supportato |
Server minimo supportato | Windows Server 2008 Datacenter, Windows Server 2008 Enterprise [solo app desktop] |
Piattaforma di destinazione | Windows |
Intestazione | certadm.h (include Certsrv.h) |
Libreria | Certadm.lib |
DLL | Certadm.dll |