ICEnroll2 ::addNameValuePairToSignature, méthode (xenroll.h)

[Cette méthode n’est plus disponible à partir de Windows Server 2008 et Windows Vista.]

La méthode addNameValuePairToSignature ajoute la paire nom-valeur authentifiée d’un attribut à la requête. Il incombe à l’autorité de certification d’interpréter la signification de la paire nom-valeur. Cette méthode a d’abord été définie dans l’interface ICEnroll2 .

Syntaxe

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

Paramètres

[in] Name

Nom de l’attribut, par exemple « 2.5.4.6 » pour le nom du pays/de la région.

[in] Value

Valeur de l’attribut, telle que « US ».

Valeur retournée

VB

La valeur de retour est un HRESULT, avec S_OK retourné si l’appel réussit.

Remarques

La méthode addNameValuePairToSignature est utilisée pour ajouter des attributs à la requête.

Exemples

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

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	xenroll.h
Bibliothèque	Uuid.lib
DLL	Xenroll.dll