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

Artigo
08/28/2023

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

A propriedade GenKeyFlags define ou recupera os valores passados para a função CryptGenKey quando a solicitação de certificado é gerada.

Por padrão, a propriedade GenKeyFlags é definida como zero. No entanto, quando um arquivo .pvk é especificado, o valor de GenKeyFlags usa como padrão CRYPT_EXPORTABLE. Para obter mais informações, consulte Comentários.

Essa propriedade foi definida pela primeira vez na interface ICEnroll .

Essa propriedade é leitura/gravação.

Sintaxe

HRESULT get_GenKeyFlags(
  LONG *pdwFlags
);

Parâmetros

pdwFlags

Valor retornado

Nenhum

Comentários

Por padrão, as chaves privadas não são exportáveis, a menos que um arquivo .pvk seja solicitado. Para tornar a chave privada exportável sem especificar um arquivo .pvk, defina GenKeyFlags como CRYPT_EXPORTABLE.

Para especificar um nome de arquivo .pvk, use a propriedade PVKFileName .

O valor da propriedade GenKeyFlags é passado para a função CriptoAPI CryptGenKey usando seu parâmetro dwFlags .

Se o provedor de serviços criptográficos (CSP) não oferecer suporte a chaves privadas exportáveis, ocorrerá um erro.

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

Nota O valor padrão para a propriedade GenKeyFlags é zero. Se você precisar alterar esse valor, deverá fazer isso antes de chamar esses métodos. Depois de chamar qualquer um desses métodos, você não pode alterar o valor da propriedade GenKeyFlags .

Exemplos

LONG     lGenKey;
HRESULT  hr;

// pEnroll is a previously instantiated ICEnroll interface pointer.

// Get the GenKeyFlags value.
hr = pEnroll->get_GenKeyFlags( &lGenKey );
if (FAILED( hr ))
    printf("Failed get_GenKeyFlags - %x\n", hr );
else
    printf( "GenKeyFlags: %d\n", lGenKey );

// Set the GenKeyFlags value.
hr = pEnroll->put_GenKeyFlags( CRYPT_EXPORTABLE );
if (FAILED( hr ))
    printf("Failed put_GenKeyFlags - %x\n", hr );
else
    printf( "GenKeyFlags set to %d\n", CRYPT_EXPORTABLE );

Requisitos


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