ICEnroll2：：addNameValuePairToSignature 方法 (xenroll.h)

[從 Windows Server 2008 和 Windows Vista 起，這個方法已不再可供使用。]

addNameValuePairToSignature 方法會將屬性的已驗證名稱/值組新增至要求。 證書頒發機構 單位 (CA) 解譯名稱/值組的意義。 這個方法最初是在 ICEnroll2 介面中定義。

語法

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

參數

[in] Name

屬性的名稱，例如國家/地區名稱的 “2.5.4.6”。

[in] Value

屬性的值，例如 “US”。

傳回值

VB

傳回值是 HRESULT，如果呼叫成功，則傳回 S_OK 。

備註

addNameValuePairToSignature 方法可用來將屬性新增至要求。

範例

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 );

規格需求

需求	值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限桌面應用程式]
目標平台	Windows
標頭	xenroll.h
程式庫	Uuid.lib
Dll	Xenroll.dll