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

  • Artigo

[Esse método não está mais disponível para uso desde o Windows Server 2008 e o Windows Vista.]

O método GetKeyLen recupera os comprimentos mínimo e máximo de chave para a assinatura e as chaves de troca. Esse método foi definido pela primeira vez na interface ICEnroll3 . Os valores recuperados por esse método dependem do provedor de serviços criptográficos atual.

Sintaxe

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

Parâmetros

[in] fMin

Valor booliano que indica qual comprimento da chave (mínimo ou máximo) é recuperado. Se fMin for TRUE, o comprimento mínimo da chave será recuperado; se for FALSE, o comprimento máximo da chave será recuperado.

[in] fExchange

Valor booliano que indica o tipo de chave. Se fExchange for TRUE, o comprimento da chave de troca será recuperado; se for FALSE, o comprimento da chave de assinatura será recuperado.

[out] pdwKeySize

Ponteiro que recebe o comprimento mínimo ou máximo da chave, em bits.

Retornar valor

C++

Se o método for bem-sucedido, o método retornará S_OK e *pdwKeySize será o valor que representa o comprimento (em bits) para o comprimento mínimo ou máximo da chave.

Se o método falhar, ele retornará um valor HRESULT que indica o erro. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT comuns.

VB

Um valor que representa o comprimento, em bits, para o comprimento mínimo ou máximo da chave.

Comentários

Chame esse método para determinar os comprimentos mínimo e máximo de chave. Se um CSP não der suporte a esse método, um erro será retornado.

Exemplos

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 Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho xenroll.h
Biblioteca Uuid.lib
DLL Xenroll.dll

Confira também

CEnroll

ICEnroll3

ICEnroll4