CertificateEnrollmentManager.CreateRequestAsync Methode
Definition
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.
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
Diese Methode gibt eine Zeichenfolge zurück, die die base64-codierte PKCS #10-Zertifikatanforderung enthält.
- Attribute
Hinweise
Die Zertifikatregistrierung kann in einem App-Container durchgefü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 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.