Metodo ICertPropertyEnrollment::Initialize (certenroll.h)

Articolo
08/22/2023

Il metodo Initialize inizializza la proprietà dall'ID richiesta di certificato, dalla stringa di configurazione dell'autorità di certificazione (CA) e da un nome visualizzato del certificato facoltativo.

Sintassi

HRESULT Initialize(
  [in]           LONG RequestId,
  [in]           BSTR strCADnsName,
  [in]           BSTR strCAName,
  [in, optional] BSTR strFriendlyName
);

Parametri

[in] RequestId

Variabile LONG contenente l'ID richiesta del certificato. Un ID richiesta viene creato dal processo di registrazione. È possibile recuperare questo valore chiamando la proprietà RequestId nell'interfaccia IX509Enrollment .

[in] strCADnsName

Variabile BSTR contenente il nome DNS (Domain Name System) della CA. Si tratta del primo nome nella stringa di configurazione CA CA CaDnsName.This is the first name in the CADnsName configuration string. La stringa di configurazione viene in genere impostata durante il processo di registrazione. Il nome DNS può essere recuperato chiamando la proprietà CAConfigString e separando la stringa nelle parti costitutive.

[in] strCAName

Variabile BSTR contenente il nome comune soggetto (CN) della CA. Si tratta del secondo nome nella stringa di configurazione CA CADnsName\CAName . La stringa di configurazione viene in genere impostata durante il processo di registrazione. Il nome CN può essere recuperato chiamando la proprietà CAConfigString e separando la stringa nelle parti costitutive.

[in, optional] strFriendlyName

Variabile BSTR che contiene un nome visualizzato facoltativo per il certificato. Il valore predefinito è NULL. Questo valore viene in genere impostato durante il processo di registrazione. È possibile recuperarlo chiamando la proprietà CertificateFriendlyName .

Valore restituito

Se la funzione ha esito positivo, la funzione restituisce S_OK.

Se la funzione ha esito negativo, restituisce un valore HRESULT che indica l'errore. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente. Per un elenco di codici di errore comuni, vedere Valori HRESULT comuni.

Codice/valore restituito	Descrizione
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)	L'oggetto è già inizializzato.

Commenti

I valori che è possibile usare per inizializzare l'oggetto ICertPropertyEnrollment vengono impostati durante il processo di registrazione del certificato quando il client chiama il metodo Enrollment nell'oggetto IX509Enrollment . Vale a dire, per recuperare un ID richiesta, chiamare la proprietà RequestId nell'oggetto IX509Enrollment . Per recuperare un nome visualizzato del certificato, chiamare la proprietà CertificateFriendlyName . Per recuperare un nome distinto e un nome comune, chiamare la proprietà CAConfigString e separare la stringa di configurazione nelle parti costitutive.

Chiamare il metodo SetValueOnCertificate per associare la proprietà a un certificato. È anche possibile chiamare le proprietà seguenti per recuperare i valori specificati durante l'inizializzazione:

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	certenroll.h
DLL	CertEnroll.dll

Vedi anche

ICertProperty

ICertPropertyEnrollment