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

[Esse método não está mais disponível para uso a partir do Windows Server 2008 e do Windows Vista.]

O método addNameValuePairToSignature adiciona o par nome-valor autenticado de um atributo à solicitação. Cabe à AC (autoridade de certificação ) interpretar o significado do par nome-valor. Esse método foi definido pela primeira vez na interface ICEnroll2 .

Sintaxe

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

Parâmetros

[in] Name

O nome do atributo, como "2.5.4.6" para o nome do país/região.

[in] Value

O valor do atributo, como "US".

Retornar valor

VB

O valor retornado é um HRESULT, com S_OK retornado se a chamada for bem-sucedida.

Comentários

O método addNameValuePairToSignature é usado para adicionar atributos à solicitação.

Exemplos

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	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	xenroll.h
Biblioteca	Uuid.lib
DLL	Xenroll.dll