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

Artículo
08/28/2023

[Esta propiedad ya no está disponible para su uso a partir de Windows Server 2008 y Windows Vista.]

La propiedad GenKeyFlags establece o recupera los valores pasados a la función CryptGenKey cuando se genera la solicitud de certificado.

De forma predeterminada, la propiedad GenKeyFlags se establece en cero. Sin embargo, cuando se especifica un archivo .pvk, el valor de GenKeyFlags tiene como valor predeterminado CRYPT_EXPORTABLE. Para obtener más información, vea la sección Comentarios.

Esta propiedad se definió por primera vez en la interfaz ICEnroll .

Esta propiedad es de lectura y escritura.

Sintaxis

HRESULT put_GenKeyFlags(
  LONG dwFlags
);

Parámetros

dwFlags

Valor devuelto

None

Observaciones

De forma predeterminada, las claves privadas no se pueden exportar a menos que se solicite un archivo .pvk. Para que la clave privada se pueda exportar sin especificar un archivo .pvk, establezca GenKeyFlags en CRYPT_EXPORTABLE.

Para especificar un nombre de archivo .pvk, use la propiedad PVKFileName .

El valor de la propiedad GenKeyFlags se pasa a la función CryptoAPI CryptGenKey mediante su parámetro dwFlags .

Si el proveedor de servicios criptográficos (CSP) no admite claves privadas exportables, se produce un error.

La propiedad GenKeyFlags afecta al comportamiento de los métodos siguientes:

Nota El valor predeterminado de la propiedad GenKeyFlags es cero. Si necesita cambiar este valor, debe hacerlo antes de llamar a estos métodos. Después de llamar a cualquiera de estos métodos, no puede cambiar el valor de la propiedad GenKeyFlags .

Ejemplos

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

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