Metodo IX509Extension::Initialize (certenroll.h)

Articolo
02/26/2024

Il metodo Initialize inizializza un oggetto IX509Extension utilizzando un identificatore di oggetto (OID) e una matrice di byte che contiene l'estensione codificata Distinguished Encoding Rules (DER). La matrice di byte con codifica DER è rappresentata da una stringa con codifica Unicode. Questo metodo è abilitato per il Web.

Sintassi

HRESULT Initialize(
  [in] IObjectId    *pObjectId,
  [in] EncodingType Encoding,
  [in] BSTR         strEncodedData
);

Parametri

[in] pObjectId

Puntatore a un'interfaccia IObjectId che contiene l'OID dell'estensione.

[in] Encoding

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

[in] strEncodedData

Variabile BSTR che contiene il valore dell'estensione con codifica 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 dei codici di errore comuni, vedere Valori HRESULT comuni.

Codice/valore restituito	Descrizione
CERTSRV_E_PROPERTY_EMPTY	Impossibile trovare l'OID.

Commenti

Un'estensione del certificato è costituita da un OID, un valore booleano che identifica se l'estensione è critica e una matrice di byte che contiene il valore di estensione. L'estensione è definita da uno standard ASN.1 ( Abstract Syntax Notation One ) e viene codificata tramite DER. È necessario specificare la matrice di byte con codifica DER come stringa che è una sequenza binaria pura o è codificata Unicode. È possibile specificare il tipo di codifica da applicare alla stringa usando l'enumerazione EncodingType .

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

IX509Extension

Condividi tramite