IEnroll4::createRequestWStr-Methode (xenroll.h)

[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.

[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

Weitere Informationen

IEnroll4