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

Artículo
03/13/2024

[Este método ya no está disponible para su uso a partir de Windows Server 2008 y Windows Vista.]

El método acceptFilePKCS7 acepta y procesa un archivo que contiene un mensaje PKCS #7 que contiene un certificado. Este método se definió por primera vez en la interfaz ICEnroll .

Sintaxis

HRESULT acceptFilePKCS7(
  [in] BSTR wszPKCS7FileName
);

Parámetros

[in] wszPKCS7FileName

Especifica el nombre del archivo que contiene el mensaje PKCS #7.

Valor devuelto

VB

El valor devuelto es hrESULT. Un valor de S_OK indica que se ha realizado correctamente. Una vez completada correctamente esta función, se aceptará el mensaje PKCS #7 del archivo.

Comentarios

De forma predeterminada, los almacenes del sistema My, Ca, Root y Request se usan para almacenar los certificados. Sin embargo, puede especificar otros almacenes asignando las siguientes propiedades antes de llamar a este método:

El método acceptFilePKCS7 difiere de acceptPKCS7 solo en que un archivo proporciona el certificado.

Ejemplos

HRESULT  hr;
BSTR     bstrFileName;

// Allocate a BSTR referencing an existing file, 
// for example, "myPKCS7.fil".
bstrFileName = SysAllocString(TEXT("<FILENAMEHERE>"));
if (NULL == bstrFileName)
{
    //handle error
}

// pEnroll is a previously instantiated ICEnroll interface pointer.
hr = pEnroll->acceptFilePKCS7( bstrFileName );
if (FAILED(hr))
    printf("Failed acceptFilePKCS7 - %x\n", hr );
else
	printf("Accepted PKCS #7 from file %ws successfully\n", 
	bstrFileName );

// Free BSTR when done.
if (bstrFileName)
    SysFreeString(bstrFileName);

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