Поделиться через


Метод ICEnroll2::addNameValuePairToSignature (xenroll.h)

[Этот метод больше недоступен для использования в Windows Server 2008 и Windows Vista.]

Метод addNameValuePairToSignature добавляет в запрос пару имя-значение атрибута, прошедшего проверку подлинности. Значение пары "имя-значение" определяет центр сертификации (ЦС). Этот метод был впервые определен в интерфейсе 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
Header xenroll.h
Библиотека Uuid.lib
DLL Xenroll.dll