UserCertificateEnrollmentManager.CreateRequestAsync Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Crea in modo asincrono una richiesta di certificato PKCS #10 in base alle proprietà specificate in un oggetto CertificateRequestProperties .
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)
Parametri
- request
- CertificateRequestProperties
Oggetto CertificateRequestProperties contenente i valori delle proprietà utilizzati per creare la richiesta di certificato.
Restituisce
Operazione asincrona per recuperare la richiesta di certificato PKCS #10 con codifica Base64.
- Attributi
Commenti
La registrazione del certificato può essere eseguita in un contenitore di app. Per inviare la richiesta, è consigliabile usare gli oggetti richiesta seguenti:
- XMLHttpRequest (JavaScript)
- HttpWebRequest (C#)
- IXMLHTTPRequest (C++)
L'oggetto CertificateRequestProperties contiene i valori predefiniti seguenti.
Proprietà | Valore predefinito |
---|---|
Oggetto | stringa vuota |
KeyAlgorithmName | RSA |
KeySize | 2048 bit |
FriendlyName | Stringa vuota |
HashAlgorithmName | SHA256 |
Exportable | Non esportabile |
KeyUsages | per la firma |
KeyProtectionLevel | NoConsent |
KeyStorageProviderName | Provider di archiviazione chiavi software Microsoft |
Mentre il metodo CreateRequestAsync crea la richiesta di certificato, è necessario inviare la richiesta a un endpoint di registrazione HTTP. È quindi possibile accettare la risposta dall'endpoint della registrazione HTTP e quindi chiamare il metodo InstallCertificateAsync per installare la risposta.
Nota
È necessario includere il valore Signing nella proprietà KeyUsages in qualsiasi oggetto CertificateRequestProperties utilizzato in una chiamata a CreateRequestAsync. Se si desidera impostare KeyUsages su Decryption o KeyAgreement, è necessario anche OR in Firma. In caso contrario, la chiamata a CreateRequestAsync avrà esito negativo.