Metodo IAlternativeName::InitializeFromOtherName (certenroll.h)

Articolo
02/23/2024

Il metodo InitializeFromOtherName inizializza l'oggetto da un identificatore di oggetto (OID) e dai dati non elaborati associati (matrice di byte). Questo metodo viene fornito per supportare il campo otherName nella dichiarazione di estensione AsN.1 AlternativeNames della sintassi astratta Notation One (ASN.1).


----------------------------------------------------------------------
-- AlternativeNames 
-- XCN_OID_SUBJECT_ALT_NAME2 (2.5.29.17)
----------------------------------------------------------------------

AltNames ::= SEQUENCE --#public-- OF GeneralName
GeneralNames ::= AltNames

GeneralName ::= CHOICE 
{
   otherName               [0] IMPLICIT OtherName,
   rfc822Name              [1] IMPLICIT IA5STRING,
   dNSName                 [2] IMPLICIT IA5STRING,
   x400Address             [3] IMPLICIT SeqOfAny,       -- Not supported
   directoryName           [4] EXPLICIT ANY,    
   ediPartyName            [5] IMPLICIT SeqOfAny,
   uniformResourceLocator  [6] IMPLICIT IA5STRING,
   iPAddress               [7] IMPLICIT OCTETSTRING,
   registeredID            [8] IMPLICIT EncodedObjectID -- Not supported
}

OtherName ::= SEQUENCE 
{
   type                    EncodedObjectID,
   value                   [0] EXPLICIT NOCOPYANY 
}

Sintassi

HRESULT InitializeFromOtherName(
  [in] IObjectId    *pObjectId,
  [in] EncodingType Encoding,
  [in] BSTR         strRawData,
  [in] VARIANT_BOOL ToBeWrapped
);

Parametri

[in] pObjectId

Puntatore a un'interfaccia IObjectId che rappresenta un OID.

[in] Encoding

Valore di enumerazione EncodingType che identifica il tipo di codifica Unicode applicato al parametro strRawData .

[in] strRawData

Variabile BSTR che contiene il nome associato all'OID.

[in] ToBeWrapped

Variabile VARIANT_BOOL che identifica se la stringa di input contenuta nel parametro strRawData è codificata e salvata come stringa ottetto (matrice di byte).

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
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)	L'oggetto è già inizializzato.

Commenti

È possibile utilizzare questa funzione per inizializzare un oggetto IAlternativeName da un OID e un valore stringa associato. La stringa è codificata in Unicode. Se si specifica true per il parametro ToBeWrapped, la stringa viene codificata usando Distinguished Encoding Rules (DER). È possibile recuperare l'OID chiamando la proprietà ObjectId . È possibile recuperare la stringa codificata o, se ToBeWrapped è true, la matrice di byte con codifica DER chiamando la proprietà RawData per recuperare la matrice di byte codificata.

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

IAlternativeName

Condividi tramite