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

  • Artículo

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

La propiedad RequestStoreName establece o recuperaICEnroll el nombre del almacén que contiene el certificado ficticio. Este certificado ficticio, junto con las claves privadas agregadas, permanece en el almacén de solicitudes hasta que una entidad de certificación procesa la solicitud y responde con un PKCS #7.

El valor predeterminado de esta propiedad es "REQUEST". Si no se va a usar el valor predeterminado, esta propiedad debe establecerse en el almacén que se usará antes de llamar a createPKCS10 o createFilePKCS10 y de nuevo antes de llamar a acceptPKCS7 o acceptFilePKCS7.

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

Esta propiedad es de lectura y escritura.

Sintaxis

HRESULT put_RequestStoreName(
  BSTR bstrName
);

Parámetros

bstrName

Valor devuelto

None

Observaciones

Normalmente, la modificación de la propiedad RequestStoreName solo se realiza en aplicaciones avanzadas. No se recomienda cambiar este valor para la mayoría de las aplicaciones.

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

La capacidad de establecer esta propiedad está deshabilitada cuando el control de inscripción de certificados se ejecuta como un control con script.

Ejemplos

BSTR     bstrStoreName = NULL;
HRESULT  hr;

// pEnroll is previously instantiated ICEnroll interface pointer

// get the storename
hr = pEnroll->get_RequestStoreName( &bstrStoreName );
if ( FAILED ( hr ) )
    printf("Failed getting RequestStoreName - %x\n", hr );
else
    printf( "RequestStoreName: %ws\n", bstrStoreName );
// free BSTR when done
if ( NULL != bstrStoreName )
    SysFreeString( bstrStoreName );

// set the storename
// bstrNewName is a BSTR that is previously set to a valid store name
hr = pEnroll->put_RequestStoreName( bstrNewName );
if ( FAILED ( hr ) )
    printf("Failed setting RequestStoreName - %x\n", hr );
else
    printf( "RequestStoreName was set to : %ws\n", bstrNewName );

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