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 |