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

[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:

• acceptPKCS7
• acceptFilePKCS7
• createPKCS10
• createFilePKCS10

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