Metodo ISignerCertificate::Initialize (certenroll.h)

Articolo
02/23/2024

Il metodo Initialize inizializza l'oggetto da un certificato di firma.

Sintassi

HRESULT Initialize(
  [in] VARIANT_BOOL         MachineContext,
  [in] X509PrivateKeyVerify VerifyType,
  [in] EncodingType         Encoding,
  [in] BSTR                 strCertificate
);

Parametri

[in] MachineContext

Variabile VARIANT_BOOL che indica se eseguire una ricerca nel contesto dell'archivio certificati del computer locale o nel contesto utente per trovare il certificato identificato dal parametro strCertificate . Specificare VARIANT_TRUE per il computer e VARIANT_FALSE per l'utente.

[in] VerifyType

Valore di enumerazione X509PrivateKeyVerify che specifica se la chiave privata usata per firmare il certificato deve essere verificata e, in tal caso, se la verifica deve essere invisibile all'utente o consentire l'input dell'utente.

[in] Encoding

Valore di enumerazione EncodingType che specifica il tipo di codifica Unicode applicato alla stringa di certificato codificata Distinguished Encoding Rules (DER).

[in] strCertificate

Variabile BSTR che contiene il certificato con codifica DER.

A partire da Windows 7 e Windows Server 2008 R2, è possibile specificare un numero di identificazione personale o un numero di serie del certificato anziché un certificato codificato. In questo modo, la funzione cerca il certificato corrispondente negli archivi locali appropriati. Tenere presente quanto segue:

BSTR deve essere un numero pari di cifre esadecimali.
Gli spazi vuoti tra coppie esadecimali vengono ignorati.
Il parametro Encoding deve essere impostato su XCN_CRYPT_STRING_HEXRAW.
Il parametro MachineContext determina se l'utente o il computer archivia o entrambe le ricerche.
Se è necessaria una chiave privata, vengono cercati solo gli archivi personali e delle richieste.
Se non è necessaria una chiave privata, vengono cercati anche gli archivi ca radice e intermedi.

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

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

Commenti

Metodo Initialize :

Verifica se la chiave privata associata al certificato esiste.
Crea un oggetto IX509SignatureInformation e lo assegna all'oggetto ISignerCertificate .
Recupera l'algoritmo di chiave pubblica dalla chiave privata.
Assegna l'algoritmo a chiave pubblica all'oggetto IX509SignatureInformation .

Impostare le proprietà seguenti prima di chiamare Initialize:

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

ISignerCertificate

Condividi tramite