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
Library Uuid.lib
DLL Xenroll.dll