Metodo IOCSPAdmin::GetConfiguration (certadm.h)

  • Articolo

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

Vedi anche

IOCSPAdmin