Metodo ICertManageModule::Configure (certmod.h)

Articolo
08/22/2023

Il metodo Configure visualizza l'interfaccia utente del modulo.

Sintassi

HRESULT Configure(
  [in] const BSTR strConfig,
  [in] BSTR       strStorageLocation,
  [in] LONG       Flags
);

Parametri

[in] strConfig

Rappresenta la stringa di configurazione per il server Servizi certificati nel formato COMPUTERNAME\CANAME, dove COMPUTERNAME è il nome di rete del server servizi certificati e CANAME è il nome comune dell'autorità di certificazione (CA) come immesso per la CA durante l'installazione di Servizi certificati. Per informazioni sul nome della stringa di configurazione, vedere ICertConfig.

[in] strStorageLocation

Posizione che fornisce l'archiviazione per i valori delle proprietà, come descritto nella definizione di strStorageLocation in ICertManageModule::GetProperty.

[in] Flags

Valore utilizzato per determinare se l'interfaccia di configurazione deve essere presentata all'utente. Se questo valore è zero, all'utente verrà visualizzata un'interfaccia per la configurazione del modulo. Se questo valore è CMM_REFRESHONLY, i servizi certificati non visualizzeranno l'interfaccia utente, ma le modifiche più recenti alla configurazione del modulo saranno effettive quando vengono elaborate richieste future di certificato (in questo modo le modifiche verranno incorporate senza richiedere una risposta a un'interfaccia utente).

Valore restituito

VB

Se il metodo ha esito positivo, il metodo 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.

Commenti

Il metodo Configure visualizza l'interfaccia utente del modulo (se presente), che consente all'utente di visualizzare e modificare gli elementi configurabili del modulo. Un modulo che implementa ICertManageModule può avere il metodo Configure chiamato quando la pagina delle proprietà Policy o Exit Module di Gestione servizi certificati è attiva e l'utente sceglie il pulsante Configura . Gestione servizi certificati passerà il percorso a cui fa riferimento strStorageLocation a questo modulo e l'implementazione di questo metodo potrà quindi usare questo percorso in base alle esigenze. Si noti che è possibile che un modulo non abbia elementi configurabili (di conseguenza, un'interfaccia utente non sarebbe necessaria), ma sarebbe comunque necessario implementare questo metodo. L'esempio seguente non consente a un utente di apportare una modifica alla configurazione, ma implementa questo metodo.

Esempio

#include <windows.h>
#include <Certmod.h>

HRESULT CCertManagePolicyModule::Configure( 
            /* [in] */ const BSTR strConfig,
            /* [in] */ BSTR strStorageLocation,
            /* [in] */ LONG Flags)
{
    if ( CMM_REFRESHONLY != Flags )
        MessageBox(NULL,
                   L"This module has no configurable items",
                   L"MyModule",
                   (MB_OK|MB_ICONINFORMATION));

    return S_OK;
}

Requisiti

Requisito	Valore
Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	certmod.h (include Certsrv.h)
Libreria	Certidl.lib

Vedi anche

ICertConfig

ICertManageModule

Condividi tramite