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

[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 formulario BSTR ) tal 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 get_SPCFileName(
  BSTR *pbstr
);

Parámetros

pbstr

Valor devuelto

None

Observaciones

El archivo se escribe como un 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:

• acceptPKCS7
• acceptFilePKCS7

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

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