Metodo ICertPolicy::Initialize (certpol.h)

Articolo
02/26/2024

Il metodo Initialize viene chiamato dal motore del server per consentire al modulo criteri di eseguire attività di inizializzazione.

Sintassi

HRESULT Initialize(
  [in] const BSTR strConfig
);

Parametri

[in] strConfig

Rappresenta il nome dell'autorità di certificazione, come immesso durante la configurazione di Servizi certificati. Per informazioni sul nome della stringa di configurazione, vedere ICertConfig2.

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 di codici di errore comuni, vedere Valori HRESULT comuni.

Commenti

Quando si scrivono moduli di criteri personalizzati, implementare questo metodo.

Esempio

#include <windows.h>
#include <Certpol.h>

STDMETHODIMP CCertPolicy::Initialize(
    /* [in] */ BSTR const strConfig)
{
    // strConfig can be used by the Policy module.
    // Here, it is stored in a BSTR member variable.
    // m_strConfig is an application-defined variable.
    // Call SysFreeString to free m_strConfig when done.
    m_strConfig = SysAllocString( strConfig );
    // Check to determine whether there was enough memory.
    if (NULL == m_strConfig)
        return ( E_OUTOFMEMORY );  // Not enough memory

    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	certpol.h (includere Certsrv.h)
Libreria	Certidl.lib