ICEnroll::acceptFilePKCS7 method (xenroll.h)

Article
02/22/2024

[This method is no longer available for use as of Windows Server 2008 and Windows Vista.]

The acceptFilePKCS7 method accepts and processes a file that contains a PKCS #7 message containing a certificate. This method was first defined in the ICEnroll interface.

Syntax

HRESULT acceptFilePKCS7(
  [in] BSTR wszPKCS7FileName
);

Parameters

[in] wszPKCS7FileName

Specifies the name of the file that contains the PKCS #7 message.

Return value

VB

The return value is an HRESULT. A value of S_OK indicates success. Upon successful completion of this function, the PKCS #7 message in the file will be accepted.

Remarks

By default, the My, Ca, Root, and Request system stores are used to store the certificates. However, you can specify other stores by assigning the following properties before calling this method:

The acceptFilePKCS7 method differs from acceptPKCS7 only in that a file supplies the certificate.

Examples

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);

Requirements

Requirement	Value
Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Target Platform	Windows
Header	xenroll.h
Library	Uuid.lib
DLL	Xenroll.dll