Metodo ICertAdmin2::GetConfigEntry (certadm.h)

  • Articolo

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

Sintassi

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

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. Questo parametro può essere una stringa vuota, nel qual caso la funzione recupera informazioni di configurazione non specifiche di una CA. Questo parametro non può essere NULL.

ImportanteGetConfigEntry 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, nel qual caso 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 vengono recuperate. Questo valore può essere una stringa vuota, nel qual caso vengono recuperati tutti i nomi delle voci. Questo parametro non può essere NULL.

[out] pvarEntry

Puntatore a un valore VARIANT che riceve le informazioni richieste.

Valore restituito

C++

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.

VB

Il valore restituito è un valore Variant che rappresenta le informazioni di configurazione recuperate.

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

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