ICEnroll4：：createFileRequest 方法 (xenroll.h)

[從 Windows Server 2008 和 Windows Vista 起，這個方法已不再可供使用。]

createFileRequest 方法會建立 PKCS #10 憑證要求、PKCS #7 要求，或透過 CMS (CMC 的完整憑證管理) 要求，並將其儲存在檔案中。這個方法最初是在 ICEnroll4 介面中定義。

語法

HRESULT createFileRequest(
  [in] LONG Flags,
  [in] BSTR strDNName,
  [in] BSTR strUsage,
  [in] BSTR strRequestFileName
);

[in] Flags

值，指定要建立的憑證類型。這可以是下列其中一個值。

[in] strDNName

此參數可以是 NULL;否則，此參數會指定進行要求之實體的辨別名稱 (DN) 。 DN 名稱必須遵循 X.500 命名慣例，例如 “CN=User， O=Microsoft”。如果兩個字母前置詞不存在，則可以改為提供 OID。

[in] strUsage

對象標識碼 (OID) ，描述所產生要求的目的，例如個人或商業 Authenticode 憑證或客戶端驗證。您也可以指定以逗號分隔的多個 OID。

[in] strRequestFileName

將接收要求的檔名。

如果方法成功，方法會 傳回S_OK。

如果方法失敗，它會傳回指出錯誤的 HRESULT 值。如需常見錯誤碼的清單，請參閱一般 HRESULT 值。

從文稿呼叫此方法時，方法會顯示使用者介面，詢問使用者是否允許建立憑證要求，以及使用者是否允許對文件系統進行寫入作業。