IEnroll4::createRequestWStr-Methode (xenroll.h)

Artikel
03/04/2024

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

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

Syntax

HRESULT createRequestWStr(
  [in]  LONG             Flags,
  [in]  LPCWSTR          pwszDNName,
  [in]  LPCWSTR          pwszUsage,
  [out] PCRYPT_DATA_BLOB pblobRequest
);

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 Unicode-Zeichenfolge, die den distinguished Name (DN) der Entität enthält, 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 Unicode-Zeichenfolge mit Null-Beendigung, die die OID enthält, 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.

[out] pblobRequest

Ein Zeiger auf eine CRYPT_DATA_BLOB-Struktur , die die Anforderung empfängt.

Wenn Sie mit der Verwendung dieses Arbeitsspeichers fertig sind, geben Sie ihn frei, indem Sie das pbData-Element dieser Struktur an die CoTaskMemFree-Funktion übergeben.

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

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

Weitere Informationen

IEnroll4

Freigeben über