Metodo ICertProperty::InitializeDecode (certenroll.h)

Articolo
02/28/2024

Il metodo InitializeDecode inizializza l'oggetto da una matrice di byte contenente il valore della proprietà. La matrice di byte è rappresentata da una stringa con codifica Unicode.

Sintassi

HRESULT InitializeDecode(
  [in] EncodingType Encoding,
  [in] BSTR         strEncodedData
);

Parametri

[in] Encoding

Valore di enumerazione EncodingType che specifica il tipo di codifica Unicode applicato alla stringa di input.

[in] strEncodedData

Variabile BSTR che contiene il valore della proprietà codificata Distinguished Encoding Rules (DER).

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

Specificare la proprietà da inizializzare chiamando la proprietà PropertyId . È possibile chiamare la proprietà RawData per recuperare il valore della proprietà codificata. Chiamare il metodo SetValueOnCertificate per associare il valore della proprietà a un certificato.

Se il metodo InitializeDecode ha esito negativo, l'oggetto ICertProperty non viene inizializzato e il valore della proprietà di input non viene salvato. Tuttavia, la proprietà PropertyId mantiene l'identificatore specificato.

Il metodo InitializeDecode viene fornito per consentire di inizializzare proprietà e proprietà personalizzate identificate nell'enumerazione CERTENROLL_PROPERTYID per cui non esiste alcuna interfaccia specifica. Ognuno dei valori supportati in tale enumerazione contiene informazioni sul tipo di dati, in genere un CRYPT_INTEGER_BLOB, che è necessario fornire al metodo InitializeDecode . È possibile usare l'interfaccia IBinaryConverter per convertire una matrice di byte in una stringa.

Le interfacce seguenti semplificano la creazione delle proprietà più comuni:

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

ICertProperties

ICertProperty

Condividi tramite