IEnroll4::createFileRequestWStr-Methode (xenroll.h)

Artikel
08/28/2023

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

Die createFileRequestWStr-Methode erstellt eine Zertifikatanforderung im PKCS #10-, PKCS #7- oder vollständigen CMC-Format (Certificate Management over CMS) und speichert sie in einer Datei. Diese Methode wurde zuerst in der IEnroll4-Schnittstelle definiert.

Syntax

HRESULT createFileRequestWStr(
  [in] LONG    Flags,
  [in] LPCWSTR pwszDNName,
  [in] LPCWSTR pwszUsage,
  [in] LPCWSTR pwszRequestFileName
);

Parameter

[in] Flags

Wert, der den Typ der zu erstellenden Zertifikatanforderung angibt. Geben Sie einen der folgenden Werte an.

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] pwszDNName

Ein Zeiger auf eine mit NULL beendete breite Zeichenfolge, die den distinguished Name (DN) der Entität darstellt, 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 mit zwei Buchstaben vorhanden ist, kann stattdessen ein Objektbezeichner (Object Identifier, OID) angegeben werden. Dieser Parameter kann NULL sein.

[in] pwszUsage

Ein Zeiger auf eine mit NULL beendete breite Zeichenfolge für die OID, die den Zweck des generierten Zertifikats beschreibt, z. B. ein einzelnes oder kommerzielles Authenticode-Zertifikat oder die Clientauthentifizierung. Sie können auch mehrere durch ein Komma getrennte OIDs angeben.

[in] pwszRequestFileName

Ein Zeiger auf eine mit NULL beendete breite Zeichenfolge, die den Namen der Datei enthält, die die Anforderung empfängt.

Rückgabewert

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.

Anforderungen


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

Weitere Informationen

IEnroll4

Freigeben über