ICEnroll4::GetKeyLenEx-Methode (xenroll.h)

Artikel
03/04/2024

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

Die GetKeyLenEx-Methode ruft Größeninformationen für die Signatur und den Austauschschlüssel ab. Diese Methode wurde zuerst in der ICEnroll4-Schnittstelle definiert.

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

Syntax

HRESULT GetKeyLenEx(
  [in]  LONG lSizeSpec,
  [in]  LONG lKeySpec,
  [out] LONG *pdwKeySize
);

Parameter

[in] lSizeSpec

Ein -Wert, der den Typ der abzurufenden Größeninformationen angibt. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
XEKL_KEYSIZE_MIN	Die minimale Schlüsselgröße.
XEKL_KEYSIZE_MAX	Die maximale Schlüsselgröße.
XEKL_KEYSIZE_INC	Die Größe des Schlüsselinkrements. Weitere Informationen finden Sie in den Hinweisen.

[in] lKeySpec

Gibt den Schlüssel an, für den Größeninformationen zurückgegeben werden. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
XEKL_KEYSPEC_KEYX	Exchange-Schlüssel
XEKL_KEYSPEC_SIG	Signaturschlüssel

[out] pdwKeySize

Ein Zeiger auf eine Variable, die die Schlüsselgröße in Bits empfängt.

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

Ein -Wert, der die Schlüsselgröße in Bits darstellt.

Hinweise

Wenn der CSP diese Methode nicht unterstützt, wird ein Fehler zurückgegeben.

Weitere Informationen zum XEKL_KEYSIZE_INC-Wert finden Sie unter PP_SIG_KEYSIZE_INC Verwendung auf der CryptGetProvParam-Referenzseite .

Beispiele

DWORD dwExchMin, dwExchMax, dwSignDef, dwSignInc;

// Determine the minimum and maximum key length values.
// hr is HRESULT variable.
hr = pEnroll4->GetKeyLenEx( XEKL_KEYSIZE_MIN,
                            XEKL_KEYSPEC_KEYX,
                            &dwExchMin );
if ( FAILED( hr ) )    
    printf("Failed GetKeyLenEx for Exchange Minimum [%x]\n", hr);
else
    printf("Exchange key Min: %d\n", dwExchMin);

hr = pEnroll4->GetKeyLenEx( XEKL_KEYSIZE_MAX,
                            XEKL_KEYSPEC_KEYX,
                            &dwExchMax );
if ( FAILED( hr ) )
    printf("Failed GetKeyLenEx for Exchange Maximum [%x]\n", hr);
else
    printf("Exchange key Max: %d\n", dwExchMax );

hr = pEnroll4->GetKeyLenEx( XEKL_KEYSIZE_DEFAULT,
                            XEKL_KEYSPEC_SIG,
                            &dwSignDef );
if ( FAILED( hr ) )
    printf("Failed GetKeyLenEx for Signature Default "
   "Key size [%x]\n", hr);
else
    printf("Signature key default size: %d\n", dwSignDef );

hr = pEnroll4->GetKeyLenEx( XEKL_KEYSIZE_INC,
                            XEKL_KEYSPEC_SIG,
                            &dwSignInc );
if ( FAILED( hr ) )    
    printf("Failed GetKeyLenEx for Signature "
   "Key Size Increment [%x]\n", hr);
else
    printf("Signature key increment size: %d\n", dwSignInc );

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