Compartir a través de

Método ICEnroll2::addNameValuePairToSignature (xenroll.h)

  • Artículo

[Este método ya no está disponible para su uso a partir de Windows Server 2008 y Windows Vista.]

El método addNameValuePairToSignature agrega el par nombre-valor autenticado de un atributo a la solicitud. Corresponde a la entidad de certificación (CA) interpretar el significado del par nombre-valor. Este método se definió por primera vez en la interfaz ICEnroll2 .

Sintaxis

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

Parámetros

[in] Name

Nombre del atributo, como "2.5.4.6" para el nombre del país o región.

[in] Value

Valor del atributo, como "US".

Valor devuelto

VB

El valor devuelto es un HRESULT, con S_OK devuelto si la llamada se realiza correctamente.

Comentarios

El método addNameValuePairToSignature se usa para agregar atributos a la solicitud.

Ejemplos

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

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado xenroll.h
Library Uuid.lib
Archivo DLL Xenroll.dll