UserCertificateEnrollmentManager.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:
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
Ein asynchroner Vorgang zum Abrufen der base64-codierten PKCS #10-Zertifikatanforderung.
- Attribute
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.