Metodo ICertProperty::InitializeFromCertificate (certenroll.h)

Il metodo InitializeFromCertificate inizializza l'oggetto usando un valore di proprietà associato a un certificato esistente.

Sintassi

HRESULT InitializeFromCertificate(
  [in] VARIANT_BOOL MachineContext,
  [in] EncodingType Encoding,
  [in] BSTR         strCertificate
);

Parametri

[in] MachineContext

Valore VARIANT_BOOL che indica se l'archivio certificati è per il computer locale o l'utente corrente. Specificare VARIANT_TRUE per il computer e VARIANT_FALSE per l'utente.

[in] Encoding

Valore di enumerazione EncodingType che specifica il tipo di codifica Unicode applicato al certificato contenuto nel parametro strCertificate .

[in] strCertificate

Variabile BSTR contenente il certificato con codifica DER.

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

• BSTR deve essere un numero pari di cifre esadecimali.
• Lo spazio vuoto tra coppie esadecimali viene ignorato.
• Il parametro Codifica deve essere impostato su XCN_CRYPT_STRING_HEXRAW.
• Il parametro MachineContext determina se l'utente o gli archivi computer o entrambi vengono cercati.
• Se è necessaria una chiave privata, vengono cercati solo gli archivi personali e delle richieste.
• Se non è necessaria una chiave privata, vengono inoltre cercati 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 di codici di errore comuni, vedere Valori HRESULT comuni.

Commenti

Specificare la proprietà da inizializzare chiamando la proprietà PropertyId . È possibile chiamare la proprietà RawData per recuperare una stringa codificata contenente la proprietà .

Requisiti

Vedi anche

ICertProperties

ICertProperty