IAlternativeName::InitializeFromOtherName method (certenroll.h)

Metode InitializeFromOtherName menginisialisasi objek dari pengidentifikasi objek (OID) dan data mentah terkait (array byte). Metode ini disediakan untuk mendukung bidang otherName dalam deklarasi ekstensi AlternativeNamesAbstract Sintaks 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 
}

Syntax

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

Parameter-parameternya

[in] pObjectId

Penunjuk ke antarmuka IObjectId yang mewakili OID.

[in] Encoding

Nilai enumerasi EncodingType yang mengidentifikasi jenis pengodean Unicode yang diterapkan ke parameter strRawData .

[in] strRawData

Variabel BSTR yang berisi nama yang terkait dengan OID.

[in] ToBeWrapped

Variabel VARIANT_BOOL yang mengidentifikasi apakah string input yang terkandung dalam parameter strRawData dikodekan dan disimpan sebagai string oktet (array byte).

Mengembalikan nilai

Jika fungsi berhasil, fungsi akan mengembalikan S_OK.

Jika fungsi gagal, fungsi mengembalikan nilai HRESULT yang menunjukkan kesalahan. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut. Untuk daftar kode kesalahan umum, lihat Nilai HRESULT Umum.

Mengembalikan kode/nilai	Description
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)	Objek sudah diinisialisasi.

Komentar

Anda dapat menggunakan fungsi ini untuk menginisialisasi objek IAlternativeName dari OID dan nilai string terkait. String dikodekan Unicode. Jika Anda menentukan true untuk parameter ToBeWrapped , string dikodekan dengan menggunakan Distinguished Encoding Rules (DER). Anda dapat mengambil OID dengan memanggil properti ObjectId . Anda dapat mengambil string yang dikodekan atau, jika ToBeWrapped benar, array byte yang dikodekan DER dengan memanggil properti RawData untuk mengambil array byte yang dikodekan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Platform Target	Windows
Header	certenroll.h
DLL	CertEnroll.dll

Lihat juga

IAlternativeName