Metodo ICertProperty::InitializeDecode (certenroll.h)

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.

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:

• ICertPropertyArchived
• ICertPropertyArchivedKeyHash
• ICertPropertyAutoEnroll
• ICertPropertyBackedUp
• ICertPropertyDescription
• ICertPropertyEnrollment
• ICertPropertyFriendlyName
• ICertPropertyKeyProvInfo
• ICertPropertyRenewal
• ICertPropertyRequestOriginator
• ICertPropertySHA1Hash

Requisiti

Vedi anche

ICertProperties

ICertProperty