Freigeben über


ICEnroll3::GetSupportedKeySpec-Methode (xenroll.h)

[Diese Methode steht ab Windows Server 2008 und Windows Vista nicht mehr zur Verfügung.]

Die GetSupportedKeySpec-Methode ruft Informationen zur aktuellen Unterstützung des Kryptografiedienstanbieters (CSP) für Signatur- und/oder Austauschvorgänge ab. Diese Methode wurde zuerst in der ICEnroll3-Schnittstelle definiert.

Die von dieser Methode abgerufenen Werte sind vom aktuellen CSP abhängig.

Syntax

HRESULT GetSupportedKeySpec(
  [out] LONG *pdwKeySpec
);

Parameter

[out] pdwKeySpec

Ein Zeiger auf einen LONG-Wert , der ein Bitflag empfängt, das angibt, ob der aktuelle CSP Austausch- und Signaturschlüssel unterstützt.

Rückgabewert

C++

Wenn die Methode erfolgreich ist, gibt die Methode S_OK zurück.

Wenn die Methode fehlschlägt, gibt sie einen HRESULT-Wert zurück, der den Fehler angibt. Eine Liste allgemeiner Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.

VB

Gibt einen Wert zurück, der angibt, ob der aktuelle CSP Austausch- und Signaturschlüssel unterstützt. Wenn der CSP diese Methode nicht unterstützt, wird ein Fehler zurückgegeben.

Hinweise

Rufen Sie diese Methode auf, um zu ermitteln, ob der aktuelle CSP Austauschschlüssel, Signaturschlüssel oder beides unterstützt. Der parameter pdwKeySpec enthält mindestens eine der folgenden Konstanten (definiert in Wincrypt.h):

  • AT_KEYEXCHANGE
  • AT_SIGNATURE

Beispiele

DWORD dwKeySpec;

// Determine the supported key specifications.
// hr is HRESULT variable.
hr = pEnroll->GetSupportedKeySpec( &dwKeySpec );
if ( FAILED( hr ) )    
    printf("Failed GetSupportedKeySpec [%x]\n", hr);
else
{
    printf("Exchange keys are %s. Signature keys are %s.\n",
           dwKeySpec & AT_KEYEXCHANGE ? "supported" : "not supported",
           dwKeySpec & AT_SIGNATURE ? "supported" : "not supported" );
}

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

Weitere Informationen

CEnroll

ICEnroll3

ICEnroll4