Metode ICEnroll2::addNameValuePairToSignature (xenroll.h)

[Metode ini tidak lagi tersedia untuk digunakan pada Windows Server 2008 dan Windows Vista.]

Metode addNameValuePairToSignature menambahkan pasangan nilai nama yang diautentikasi dari atribut ke permintaan. Terserah otoritas sertifikasi (CA) untuk menafsirkan arti pasangan nama-nilai. Metode ini pertama kali didefinisikan dalam antarmuka ICEnroll2 .

Sintaks

HRESULT addNameValuePairToSignature(
  [in] BSTR Name,
  [in] BSTR Value
);

Parameter

[in] Name

Nama atribut, seperti "2.5.4.6" untuk nama negara/wilayah.

[in] Value

Nilai atribut , seperti "US".

Nilai kembali

VB

Nilai yang dikembalikan adalah HRESULT, dengan S_OK dikembalikan jika panggilan berhasil.

Keterangan

Metode addNameValuePairToSignature digunakan untuk menambahkan atribut ke permintaan.

Contoh

BSTR bstrName = NULL;
BSTR bstrValue = NULL;
HRESULT hr;

// Allocate the name. Alternatively, (L"2.5.4.6").
bstrName = SysAllocString(TEXT(szOID_COUNTRY_NAME));
// Allocate the value.
bstrValue = SysAllocString(L"US");

if (NULL == bstrName || NULL == bstrValue)
{
    // handle error
}

// add the name-value pair to the signature
// pEnroll is previously instantiated ICEnroll4 interface pointer
hr = pEnroll->addNameValuePairToSignature( bstrName, bstrValue );
if ( FAILED( hr ) )
    printf("Failed addNameValuePairToSignature - %x\n", hr );
else
    printf("addNameValuePairToSignature(%ws, %ws) succeeded\n",
            bstrName, 
            bstrValue );

// free BSTRs
if (bstrName )
    SysFreeString( bstrName );
if (bstrValue )
    SysFreeString( bstrValue );

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	xenroll.h
Pustaka	Uuid.lib
DLL	Xenroll.dll