ICEnroll3 ::GetKeyLen, méthode (xenroll.h)

Article
03/04/2024

[Cette méthode n’est plus disponible à partir de Windows Server 2008 et Windows Vista.]

La méthode GetKeyLen récupère les longueurs de clé minimales et maximales pour les clés de signature et d’échange. Cette méthode a d’abord été définie dans l’interface ICEnroll3 . Les valeurs récupérées par cette méthode dépendent du fournisseur de services de chiffrement actuel.

Syntaxe

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

Paramètres

[in] fMin

Valeur booléenne indiquant la longueur de clé (minimale ou maximale) récupérée. Si fMin a la valeur TRUE, la longueur de clé minimale est récupérée ; si la valeur est FALSE, la longueur maximale de la clé est récupérée.

[in] fExchange

Valeur booléenne indiquant le type de clé. Si fExchange a la valeur TRUE, la longueur de la clé d’échange est récupérée ; si elle a la valeur FALSE, la longueur de la clé de signature est récupérée.

[out] pdwKeySize

Pointeur qui reçoit la longueur minimale ou maximale de la clé, en bits.

Valeur retournée

C++

Si la méthode réussit, la méthode retourne S_OK, et *pdwKeySize sera la valeur représentant la longueur (en bits) de la longueur minimale ou maximale de la clé.

Si la méthode échoue, elle retourne une valeur HRESULT qui indique l’erreur. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.

VB

Valeur qui représente la longueur, en bits, de la longueur minimale ou maximale de la clé.

Remarques

Appelez cette méthode pour déterminer les longueurs de clé minimales et maximales. Si un fournisseur de solutions Cloud ne prend pas en charge cette méthode, une erreur est retournée.

Exemples

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

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	xenroll.h
Bibliothèque	Uuid.lib
DLL	Xenroll.dll