Compartilhar via


Método ICEnroll::p ut_KeySpec (xenroll.h)

[Essa propriedade não está mais disponível para uso a partir do Windows Server 2008 e do Windows Vista.]

A propriedade KeySpec define ou recupera o tipo de chave gerada.

Os valores válidos são determinados pelo CSP ( provedor de serviços criptográficos ) em uso. Essa propriedade foi definida pela primeira vez na interface ICEnroll .

Essa propriedade é leitura/gravação.

Sintaxe

HRESULT put_KeySpec(
  LONG dw
);

Parâmetros

dw

Valor retornado

Nenhum

Comentários

Para o Provedor Criptográfico base da Microsoft, a propriedade KeySpec tem um valor de AT_KEYEXCHANGE para chaves de troca ou AT_SIGNATURE para chaves de assinatura. O padrão é AT_SIGNATURE.

Para obter informações sobre os outros CSPs da Microsoft, consulte Provedores de Serviços Criptográficos na documentação do CryptoAPI 2.0.

Para obter informações sobre outros CSPs, consulte a documentação fornecida com o CSP.

A propriedade KeySpec afeta o comportamento dos seguintes métodos:

Exemplos

DWORD    dwKeySpec;
HRESULT  hr;

// pEnroll is previously instantiated ICEnroll interface pointer

// get the KeySpec value
hr = pEnroll->get_KeySpec( &dwKeySpec );
if (FAILED( hr ))
    printf("Failed get_KeySpec - %x\n", hr );
else
    printf( "KeySpec: %d\n", dwKeySpec );

// set the KeySpec value
hr = pEnroll->put_KeySpec( AT_KEYEXCHANGE );
if (FAILED( hr ))
    printf("Failed put_KeySpec - %x\n", hr );
else
    printf( "KeySpec set to %d\n", AT_KEYEXCHANGE );

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