Metodo ICertPropertyRenewal::Initialize (certenroll.h)

Il metodo Initialize inizializza l'oggetto da un hash SHA-1 del nuovo certificato.

Sintassi

HRESULT Initialize(
  [in] EncodingType Encoding,
  [in] BSTR         strRenewalValue
);

Parametri

[in] Encoding

Valore di enumerazione EncodingType che specifica il tipo di codifica Unicode applicato alla stringa di input contenente l'hash.

[in] strRenewalValue

Variabile BSTR contenente l'hash.

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

In genere questa proprietà viene inizializzata durante il processo di registrazione. È possibile recuperare il certificato usato durante la registrazione chiamando la proprietà Certificate nell'interfaccia IX509Enrollment .

Chiamare il metodo SetValueOnCertificate per associare la proprietà a un certificato. Chiamare la proprietà Renewal per recuperare l'hash.

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

ICertPropertyRenewal