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

  • Artículo

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

La propiedad SPCFileName establece o recupera el nombre del archivo en el que se va a escribir el PKCS #7 codificado en base64 (en formato BSTR ) tal y como se devuelve de la entidad de certificación.

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

Esta propiedad es de lectura y escritura.

Sintaxis

HRESULT put_SPCFileName(
  BSTR bstr
);

Parámetros

bstr

Valor devuelto

None

Observaciones

El archivo se escribe como un archivo PKCS #7 binario. Especificar este archivo no afecta a la aceptación de los certificados en ninguno de los almacenes del usuario.

Si el archivo ya existe, se le notificará al usuario y se le pedirá permiso para sobrescribirlo.

SPCFileName afecta al comportamiento de los métodos siguientes:

Ejemplos

BSTR     bstrSPCFile = NULL;
BSTR     bstrNewSPCFile = NULL;
HRESULT  hr;

// pEnroll is previously instantiated ICEnroll interface pointer

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

// set the SPCFileName, for example, "MyFile.SPC".
bstrNewSPCFile = SysAllocString(TEXT("<FILENAMEHERE>"));

hr = pEnroll->put_SPCFileName( bstrNewSPCFile );
if (FAILED( hr ))
    printf("Failed put_SPCFileName - %x\n", hr );
else
    printf( "SPCFileName set to %ws\n", bstrNewSPCFile );
// free BSTR when done
if ( NULL != bstrNewSPCFile )
    SysFreeString( bstrNewSPCFile );

Requisitos

   
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