ICEnroll::acceptFilePKCS7-Methode (xenroll.h)

Artikel
03/06/2024

[Diese Methode steht ab Windows Server 2008 und Windows Vista nicht mehr zur Verfügung.]

Die acceptFilePKCS7-Methode akzeptiert und verarbeitet eine Datei, die eine PKCS #7-Nachricht mit einem Zertifikat enthält. Diese Methode wurde zuerst in der ICEnroll-Schnittstelle definiert.

Syntax

HRESULT acceptFilePKCS7(
  [in] BSTR wszPKCS7FileName
);

Parameter

[in] wszPKCS7FileName

Gibt den Namen der Datei an, die die PKCS #7-Nachricht enthält.

Rückgabewert

VB

Der Rückgabewert ist ein HRESULT. Ein Wert von S_OK gibt den Erfolg an. Nach erfolgreicher Ausführung dieser Funktion wird die PKCS #7-Meldung in der Datei akzeptiert.

Hinweise

Standardmäßig werden die Systemspeicher My, Ca, Root und Request zum Speichern der Zertifikate verwendet. Sie können jedoch andere Speicher angeben, indem Sie die folgenden Eigenschaften zuweisen, bevor Sie diese Methode aufrufen:

Die acceptFilePKCS7-Methode unterscheidet sich von acceptPKCS7 nur dadurch, dass eine Datei das Zertifikat bereitstellt.

Beispiele

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	xenroll.h
Bibliothek	Uuid.lib
DLL	Xenroll.dll