Metodo ICEnroll3::GetKeyLen (xenroll.h)

Articolo
08/28/2023

[Questo metodo non è più disponibile per l'uso a partire da Windows Server 2008 e Windows Vista.]

Il metodo GetKeyLen recupera le lunghezze minime e massime della chiave per le chiavi di firma e scambio. Questo metodo è stato definito per la prima volta nell'interfaccia ICEnroll3 . I valori recuperati da questo metodo dipendono dal provider di servizi di crittografia corrente.

Sintassi

HRESULT GetKeyLen(
  [in]  BOOL fMin,
  [in]  BOOL fExchange,
  [out] LONG *pdwKeySize
);

Parametri

[in] fMin

Valore booleano che indica quale lunghezza della chiave (minima o massima) viene recuperata. Se fMin è TRUE, viene recuperata la lunghezza minima della chiave; se è FALSE, viene recuperata la lunghezza massima della chiave.

[in] fExchange

Valore booleano che indica il tipo di chiave. Se fExchange è TRUE, viene recuperata la lunghezza della chiave di scambio; se è FALSE, viene recuperata la lunghezza della chiave di firma.

[out] pdwKeySize

Puntatore che riceve la lunghezza minima o massima della chiave, in bit.

Valore restituito

C++

Se il metodo ha esito positivo, il metodo restituisce S_OK e *pdwKeySize sarà il valore che rappresenta la lunghezza (in bit) per la lunghezza minima o massima della chiave.

Se il metodo ha esito negativo, restituisce un valore HRESULT che indica l'errore. Per un elenco di codici di errore comuni, vedere Valori HRESULT comuni.

VB

Valore che rappresenta la lunghezza, in bit, per la lunghezza minima o massima della chiave.

Commenti

Chiamare questo metodo per determinare la lunghezza minima e massima della chiave. Se un CSP non supporta questo metodo, viene restituito un errore.

Esempio

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

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	xenroll.h
Libreria	Uuid.lib
DLL	Xenroll.dll