Interfaccia IX509NameValuePair (certenroll.h)

Articolo
02/26/2024

L'interfaccia IX509NameValuePair rappresenta una coppia nome-valore generica. Sebbene siano presenti alcune coppie nome-valore comuni create dal processo di richiesta del certificato e registrazione, è possibile usare questo oggetto per specificare qualsiasi nome e valore. Un insieme IX509NameValuePairs può essere recuperato da un oggetto IX509Enrollment e da un oggetto IX509CertificateRequestCmc . Le raccolte non sono correlate.

coppie nome-valore e l'oggetto di registrazione:: Prima che un oggetto IX509Enrollment invii una richiesta di certificato a un'autorità di certificazione (CA), la raccolta nome-valore viene codificata come stringa di attributo concatenata con il formato Name1:Value1:Name2:Value2\. È possibile recuperare la raccolta chiamando la proprietà NameValuePairs . È possibile usare l'oggetto IX509NameValuePairs per aggiungere coppie nome-valore all'insieme.

coppie nome-valore e l'oggetto richiesta CMC:

Un oggetto richiesta CMC (IX509CertificateRequestCmc) contiene sequenze di strutture TaggedAttribute, TaggedRequest e TaggedContentInfo ASN.1. Per altre informazioni, vedere Attributi CMC

La struttura TaggedAttribute può contenere un attributo RegInfo . Questo attributo è costituito da una matrice di byte che contiene l'insieme di coppie nome-valore. La matrice di byte viene creata nel modo seguente:

Ogni stringa nome-valore è standardizzata. Ad esempio, gli escape "%5C" vengono sostituiti per i caratteri della barra rovesciata (\\).
Ogni coppia nome-valore viene concatenata usando un segno uguale (=).
Tutte le coppie sono concatenate usando un amperand (&)tra ogni coppia.
Il risultato viene codificato come stringa UTF-8.

Nell'esempio seguente viene illustrato l'output ASN.1 per un certificato CMC che contiene un attributo RegInfo contenente una singola coppia nome-valore di "RequesterName=Domain\TargetUser".


...
30 33              ; SEQUENCE (33 Bytes)
   02 01                            ; INTEGER (1 Bytes)
   |  02
   06 08                            ; OBJECT_ID (8 Bytes)
   |  2b 06 01 05 05 07 07 12
   |     ; 1.3.6.1.5.5.7.7.18 Reg Info
   31 24                ; SET (24 Bytes)
      04 22 ; OCTET_STRING (22 Bytes)
      52 65 71 75 65 73 74 65  72 4e 61 6d 65 3d 44 6f  ; RequesterName=Do
      6d 61 69 6e 25 35 43 54  61 72 67 65 74 55 73 65  ; main%5CTargetUse
      72 26                                             ; r&amp; 
...

Ereditarietà

L'interfaccia IX509NameValuePair eredita dall'interfaccia IDispatch . IX509NameValuePair include anche questi tipi di membri:

Metodi

L'interfaccia IX509NameValuePair include questi metodi.


IX509NameValuePair::get_Name Recupera la parte del nome della coppia nome-valore.
IX509NameValuePair::get_Value Recupera la parte del valore della coppia nome-valore.
IX509NameValuePair::Initialize Inizializza l'oggetto dalle stringhe che contengono il nome e il valore associato.

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

Vedi anche

Interfacce CertEnroll

Idispatch

IX509NameValuePairs