UserCertificateEnrollmentManager.CreateRequestAsync 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
根據 CertificateRequestProperties 物件中指定的屬性，以非同步方式建立 PKCS #10 憑證要求。
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)參數
- request
- CertificateRequestProperties
CertificateRequestProperties物件，其中包含用來建立憑證要求的屬性值。
傳回
用來擷取 base64 編碼 PKCS #10 憑證要求的非同步作業。
- 屬性
備註
憑證註冊可以在應用程式容器中執行。 建議您使用下列要求物件來提交要求：
- XMLHttpRequest (JavaScript)
- HttpWebRequest (C#)
- IXMLHTTPRequest (C++)
CertificateRequestProperties物件包含下列預設值。
| 屬性 | 預設值 |
|---|---|
| 主旨 | 空字串 |
| KeyAlgorithmName | RSA |
| KeySize | 2048 位元 |
| FriendlyName | 空字串 |
| HashAlgorithmName | SHA256 |
| Exportable | 不可匯出 |
| KeyUsages | 簽署 |
| KeyProtectionLevel | NoConsent |
| KeyStorageProviderName | Microsoft 軟體金鑰儲存提供者 |
雖然 CreateRequestAsync 方法會建立憑證要求，但您必須將要求提交至 HTTP 註冊端點。 然後，您可以從 HTTP 註冊端點取得回應，然後呼叫 InstallCertificateAsync 方法來安裝回應。
注意
您必須在KeyUsages屬性中包含您在CreateRequestAsync呼叫中使用的CertificateRequestProperties物件中的簽署值。 如果您想要將 KeyUsages 設定為 Decryption 或 KeyAgreement，您也必須在 [簽署] 中設定 OR。 否則， 呼叫 CreateRequestAsync 將會失敗。