Metodo ICEnroll2::addNameValuePairToSignature (xenroll.h)

  • Articolo

[Questo metodo non è più disponibile per l'uso a partire da Windows Server 2008 e Windows Vista.]

Il metodo addNameValuePairToSignature aggiunge la coppia nome-valore autenticata di un attributo alla richiesta. È necessario che l'autorità di certificazione (CA) interpreti il significato della coppia nome-valore. Questo metodo è stato definito per la prima volta nell'interfaccia ICEnroll2 .

Sintassi

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

Parametri

[in] Name

Nome dell'attributo, ad esempio "2.5.4.6" per il nome paese/area geografica.

[in] Value

Valore dell'attributo, ad esempio "US".

Valore restituito

VB

Il valore restituito è un HRESULT, con S_OK restituito se la chiamata ha esito positivo.

Commenti

Il metodo addNameValuePairToSignature viene usato per aggiungere attributi alla richiesta.

Esempio

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

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione xenroll.h
Libreria Uuid.lib
DLL Xenroll.dll