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

值，指定要建立的憑證要求類型。 指定下列其中一個值。

值 意義
XECR_CMC
 完整 CMC
XECR_PKCS10_V1_5
 PKCS #10
XECR_PKCS10_V2_0
 PKCS #10 第 2 版
XECR_PKCS7
 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

另請參閱

IEnroll4