IEnroll4::createRequestWStr 方法 (xenroll.h)
[此方法已不再可供 Windows Server 2008 和 Windows Vista 使用。]
createRequestWStr 方法會透過 CMS 建立 PKCS #10、PKCS #7 或完整憑證管理, (CMC) 格式憑證要求,並將其儲存在 BLOB 中。 此方法最初是在 IEnroll4 介面中定義。
語法
HRESULT createRequestWStr(
[in] LONG Flags,
[in] LPCWSTR pwszDNName,
[in] LPCWSTR pwszUsage,
[out] PCRYPT_DATA_BLOB pblobRequest
);
參數
[in] Flags
值,指定要建立的憑證要求類型。 指定下列其中一個值。
值 | 意義 |
---|---|
|
完整 CMC |
|
PKCS #10 |
|
PKCS #10 第 2 版 |
|
PKCS #7 |
[in] pwszDNName
Null 終止 Unicode 字串的指標,其中包含發出要求之實體的辨別名稱 (DN) 。 DN 名稱必須遵循 X.500 命名慣例,例如 “CN=User, O=Microsoft”。 如果兩個字母前置詞不存在,可能會改為提供 OID) (對象識別碼。 此參數可以是 NULL。
[in] pwszUsage
Null 終止 Unicode 字串的指標,其中包含描述所產生憑證目的的 OID,例如個人或商業 Authenticode 憑證或客戶端驗證。 您也可以指定以逗號分隔的多個 OID。
[out] pblobRequest
接收要求之 CRYPT_DATA_BLOB 結構的指標。
當您完成使用此記憶體時,請將這個結構的 pbData 成員傳遞至 CoTaskMemFree 函式來釋放它。
傳回值
如果方法成功,方法會傳回S_OK。
如果方法失敗,它會傳回 HRESULT 值,指出錯誤。 如需常見錯誤碼的清單,請參閱 一般 HRESULT 值。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | xenroll.h |
程式庫 | Uuid.lib |
Dll | Xenroll.dll |