Método ICEnroll3::GetKeyLen (xenroll.h)

Artículo
03/09/2024

[Este método ya no está disponible para su uso a partir de Windows Server 2008 y Windows Vista.]

El método GetKeyLen recupera las longitudes de clave mínima y máxima para la firma y las claves de intercambio. Este método se definió por primera vez en la interfaz ICEnroll3 . Los valores recuperados por este método dependen del proveedor de servicios criptográficos actual.

Sintaxis

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

Parámetros

[in] fMin

Valor booleano que indica la longitud de clave (mínima o máxima) que se recupera. Si fMin es TRUE, se recupera la longitud mínima de la clave; si es FALSE, se recupera la longitud máxima de la clave.

[in] fExchange

Valor booleano que indica el tipo de clave. Si fExchange es TRUE, se recupera la longitud de la clave de intercambio; si es FALSE, se recupera la longitud de la clave de firma.

[out] pdwKeySize

Puntero que recibe la longitud mínima o máxima de la clave, en bits.

Valor devuelto

C++

Si el método se realiza correctamente, el método devuelve S_OK y *pdwKeySize será el valor que representa la longitud (en bits) de la longitud mínima o máxima de la clave.

Si se produce un error en el método, devuelve un valor HRESULT que indica el error. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.

VB

Valor que representa la longitud, en bits, de la longitud mínima o máxima de la clave.

Comentarios

Llame a este método para determinar las longitudes de clave mínima y máxima. Si un CSP no admite este método, se devuelve un error.

Ejemplos

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

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	xenroll.h
Library	Uuid.lib
Archivo DLL	Xenroll.dll