ICEnroll4::createFileRequest-Methode (xenroll.h)

Artikel
03/04/2024

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

Die createFileRequest-Methode erstellt eine PKCS #10-Zertifikatanforderung, eine PKCS #7-Anforderung oder eine vollständige CMC-Anforderung ( Certificate Management over CMS ) und speichert sie in einer Datei. Diese Methode wurde zuerst in der ICEnroll4-Schnittstelle definiert.

Syntax

HRESULT createFileRequest(
  [in] LONG Flags,
  [in] BSTR strDNName,
  [in] BSTR strUsage,
  [in] BSTR strRequestFileName
);

Parameter

[in] Flags

Ein Wert, der den Typ des zu erstellenden Zertifikats angibt. Dies kann einer der folgenden Werte sein.

Wert	Bedeutung
XECR_CMC	Vollständige CMC
XECR_PKCS10_V1_5	PKCS 10
XECR_PKCS10_V2_0	PKCS 10 Version 2
XECR_PKCS7	PKCS 7

[in] strDNName

Dieser Parameter kann NULL sein. Andernfalls gibt dieser Parameter den distinguished Name (DN) der Entität an, für die die Anforderung gestellt wird. Der DN-Name muss der X.500-Benennungskonvention entsprechen, z. B. "CN=User, O=Microsoft". Wenn kein Präfix aus zwei Buchstaben vorhanden ist, kann stattdessen eine OID angegeben werden.

[in] strUsage

Ein Objektbezeichner (Object Identifier, OID), der den Zweck der generierten Anforderung beschreibt, z. B. ein individuelles oder kommerzielles Authenticode-Zertifikat oder die Clientauthentifizierung. Sie können auch mehrere durch ein Komma getrennte OIDs angeben.

[in] strRequestFileName

Der Name der Datei, die die Anforderung empfängt.

Rückgabewert

VB

Wenn die Methode erfolgreich ist, gibt die Methode S_OK zurück.

Wenn die Methode fehlschlägt, gibt sie einen HRESULT-Wert zurück, der den Fehler angibt. Eine Liste allgemeiner Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.

Hinweise

Wenn diese Methode aus einem Skript aufgerufen wird, zeigt die Methode eine Benutzeroberfläche an, die fragt, ob der Benutzer die Erstellung einer Zertifikatanforderung zulässt und ob der Benutzer einen Schreibvorgang für das Dateisystem zulässt.

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

Freigeben über