UserCertificateEnrollmentManager.CreateRequestAsync Methode

Definition

Namespace:

Windows.Security.Cryptography.Certificates

Erstellt asynchron eine PKCS #10-Zertifikatanforderung basierend auf Eigenschaften, die in einem CertificateRequestProperties-Objekt angegeben sind.

public:
 virtual IAsyncOperation<Platform::String ^> ^ CreateRequestAsync(CertificateRequestProperties ^ request) = CreateRequestAsync;

/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<winrt::hstring> CreateRequestAsync(CertificateRequestProperties const& request);

[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<string> CreateRequestAsync(CertificateRequestProperties request);

function createRequestAsync(request)

Public Function CreateRequestAsync (request As CertificateRequestProperties) As IAsyncOperation(Of String)

Parameter

request

CertificateRequestProperties

Ein CertificateRequestProperties-Objekt , das die Eigenschaftswerte enthält, die zum Erstellen der Zertifikatanforderung verwendet werden.

Gibt zurück

IAsyncOperation<String>

IAsyncOperation<Platform::String>

IAsyncOperation<winrt::hstring>

Ein asynchroner Vorgang zum Abrufen der base64-codierten PKCS #10-Zertifikatanforderung.

Attribute

RemoteAsyncAttribute

Hinweise

Die Zertifikatregistrierung kann in einem App-Container ausgeführt werden. Es wird empfohlen, die folgenden Anforderungsobjekte zu verwenden, um die Anforderung zu übermitteln:

• XMLHttpRequest (JavaScript)
• HttpWebRequest (C#)
• IXMLHTTPRequest (C++)

Das CertificateRequestProperties-Objekt enthält die folgenden Standardwerte.

Eigenschaft	Standardwert
Subject	leere Zeichenfolge
KeyAlgorithmName	RSA
Keysize	2.048 Bits
Friendlyname	Leere Zeichenfolge
HashAlgorithmName	SHA256
Exportable	Nicht exportierbar
KeyUsages	Signieren
KeyProtectionLevel	NoConsent
KeyStorageProviderName	Microsoft-Softwareschlüsselspeicheranbieter

Während die CreateRequestAsync-Methode die Zertifikatanforderung erstellt, müssen Sie die Anforderung an einen HTTP-Registrierungsendpunkt senden. Sie können dann die Antwort vom HTTP-Registrierungsendpunkt abrufen und dann die InstallCertificateAsync-Methode aufrufen, um die Antwort zu installieren.

Hinweis

Sie müssen den Wert Signing in die KeyUsages-Eigenschaft in jedes CertificateRequestProperties-Objekt einschließen, das Sie in einem Aufruf von CreateRequestAsync verwenden. Wenn Sie KeyUsages auf Decryption oder KeyAgreement festlegen möchten, müssen Sie auch ODER unter Signieren. Andernfalls schlägt der Aufruf von CreateRequestAsync fehl.

Weitere Informationen

• CertificateEnrollmentManager