Método ICEnroll::get_KeySpec (xenroll.h)

[Essa propriedade não está mais disponível para uso desde o Windows Server 2008 e o 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 get_KeySpec(
  LONG *pdw
);

Parâmetros

pdw

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:

• createPKCS10
• createFilePKCS10

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