ICEnroll3::GetKeyLen-Methode (xenroll.h)
[Diese Methode steht ab Windows Server 2008 und Windows Vista nicht mehr zur Verfügung.]
Die GetKeyLen-Methode ruft die minimale und maximale Schlüssellänge für die Signatur - und Austauschschlüssel ab. Diese Methode wurde zuerst in der ICEnroll3-Schnittstelle definiert. Die von dieser Methode abgerufenen Werte sind vom aktuellen Kryptografiedienstanbieter abhängig.
Syntax
HRESULT GetKeyLen(
[in] BOOL fMin,
[in] BOOL fExchange,
[out] LONG *pdwKeySize
);
Parameter
[in] fMin
Boolescher Wert, der angibt, welche Schlüssellänge (Minimum oder Maximum) abgerufen wird. Wenn fMintrue ist, wird die minimale Schlüssellänge abgerufen. wenn es FALSE ist, wird die maximale Schlüssellänge abgerufen.
[in] fExchange
Boolescher Wert, der den Schlüsseltyp angibt. Wenn fExchangeTRUE ist, wird die Exchange-Schlüssellänge abgerufen. wenn es FALSE ist, wird die Signaturschlüssellänge abgerufen.
[out] pdwKeySize
Zeiger, der die minimale oder maximale Länge des Schlüssels in Bits empfängt.
Rückgabewert
C++
Wenn die Methode erfolgreich ist, gibt die Methode S_OK zurück, und *pdwKeySize ist der Wert, der die Länge (in Bits) für die minimale oder maximale Länge des Schlüssels darstellt.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 Länge in Bits für die minimale oder maximale Länge des Schlüssels darstellt.Hinweise
Rufen Sie diese Methode auf, um die minimale und maximale Schlüssellänge zu bestimmen. Wenn ein CSP diese Methode nicht unterstützt, wird ein Fehler zurückgegeben.
Beispiele
DWORD dwExchMin, dwExchMax, dwSignMin, dwSignMax;
// Determine the minimum and maximum key length values.
// hr is HRESULT variable.
hr = pEnroll->GetKeyLen( TRUE, TRUE, &dwExchMin );
if ( FAILED( hr ) )
printf("Failed GetKeyLen for Exchange Minimum [%x]\n", hr);
else
printf("Exchange key Min: %d\n", dwExchMin);
hr = pEnroll->GetKeyLen( FALSE, TRUE, &dwExchMax );
if ( FAILED( hr ) )
printf("Failed GetKeyLen for Exchange Maximum [%x]\n", hr);
else
printf("Exchange key Max: %d\n", dwExchMax );
hr = pEnroll->GetKeyLen( TRUE, FALSE, &dwSignMin );
if ( FAILED( hr ) )
printf("Failed GetKeyLen for Signature Minimum [%x]\n", hr);
else
printf("Signature key Min: %d\n", dwSignMin );
hr = pEnroll->GetKeyLen( FALSE, FALSE, &dwSignMax );
if ( FAILED( hr ) )
printf("Failed GetKeyLen for Signature Maximum [%x]\n", hr);
else
printf("Signature key Max: %d\n", dwSignMax );
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 |