CertificateEnrollmentManager.CreateRequestAsync Methode

Referenz

Definition

Namespace:: Windows.Security.Cryptography.Certificates

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

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

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

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

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

function createRequestAsync(request)

Public Shared 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>

Diese Methode gibt eine Zeichenfolge zurück, die die base64-codierte PKCS #10-Zertifikatanforderung enthält.

Attribute: RemoteAsyncAttribute

Hinweise

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

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 Software Key Storage-Anbieter

Während die CreateRequestAsync-Methode die Zertifikatanforderung erstellt, müssen Sie die Anforderung an einen HTTP-Registrierungsendpunkt übermitteln. Anschließend können Sie 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 OR in Signieren. Andernfalls schlägt der Aufruf von CreateRequestAsync fehl.

Gilt für:

Share via