ICEnroll2::addNameValuePairToSignature-Methode (xenroll.h)

Artikel
03/13/2024

[Diese Methode ist ab Windows Server 2008 und Windows Vista nicht mehr verfügbar.]

Die addNameValuePairToSignature-Methode fügt der Anforderung das authentifizierte Name-Wert-Paar eines Attributs hinzu. Es liegt an der Zertifizierungsstelle (Ca ), die Bedeutung des Name-Wert-Paars zu interpretieren. Diese Methode wurde zuerst in der ICEnroll2-Schnittstelle definiert.

Syntax

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

Parameter

[in] Name

Der Name des Attributs, z. B. "2.5.4.6" für den Land-/Regionsnamen.

[in] Value

Der Wert des Attributs, z. B. "US".

Rückgabewert

VB

Der Rückgabewert ist ein HRESULT, wobei S_OK zurückgegeben wird, wenn der Aufruf erfolgreich ist.

Hinweise

Die addNameValuePairToSignature-Methode wird verwendet, um der Anforderung Attribute hinzuzufügen.

Beispiele

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	xenroll.h
Bibliothek	Uuid.lib
DLL	Xenroll.dll

Freigeben über