CryptDecodeObject 函式 (wincrypt.h)
CryptDecodeObject函式會解碼lpszStructType參數所指示之型別的結構。 建議使用 CryptDecodeObjectEx 作為 API，以大幅改善效能來執行相同的函式。
語法
BOOL CryptDecodeObject(
[in] DWORD dwCertEncodingType,
[in] LPCSTR lpszStructType,
[in] const BYTE *pbEncoded,
[in] DWORD cbEncoded,
[in] DWORD dwFlags,
[out] void *pvStructInfo,
[in, out] DWORD *pcbStructInfo
);
參數
[in] dwCertEncodingType
使用的編碼類型。 將憑證和 訊息編碼類型 與位OR 作業結合在一起，一律可以接受，如下列範例所示：
X509_ASN_ENCODING |PKCS_7_ASN_ENCODING
目前定義的編碼類型如下：
- X509_ASN_ENCODING
- PKCS_7_ASN_ENCODING
[in] lpszStructType
定義結構類型的 OID 指標。 如果 lpszStructType 參數的高序單字為零，則低順序字組會指定指定結構類型的整數識別碼。 否則，此參數是 Null 終止字串的長指標。
如需物件識別碼字串、其預先定義的常數和對應的結構的詳細資訊，請參閱 CryptEncodeObject 和 CryptDecodeObject 的常數。
[in] pbEncoded
要解碼之編碼結構的指標。
[in] cbEncoded
pbEncoded所指向的位元組數目。
[in] dwFlags
定義下列旗標。 它們可以與位OR 運算結合。
[out] pvStructInfo
要接收已解碼結構的緩衝區指標。 當指定的緩衝區不夠大而無法接收解碼的結構時，函式會設定ERROR_MORE_DATA程式碼，並將所需的緩衝區大小以位元組為單位儲存在 由tructInfo所指向的變數中。
此參數可以是 Null ，可擷取此資訊的大小以供記憶體配置之用。 如需詳細資訊，請參閱 擷取未知長度的資料。
[in, out] pcbStructInfo
DWORD值的指標，指定pvStructInfo參數所指向之緩衝區的大小，以位元組為單位。 當函式傳回時，這個 DWORD 值會包含複製到 pvStructInfo的解碼資料大小。 由 wifiStructInfo指向之變數中包含的大小可以指出大於解碼結構的大小，因為解碼的結構可以包含其他結構的指標。 此大小是解碼結構和其他所指向結構所需的大小總和。
傳回值
如果函式成功，傳回值為非零 (TRUE) 。
如果函式失敗，傳回值為零， (FALSE) 。 如需擴充的錯誤資訊，請呼叫 GetLastError。 下表列出一些可能的錯誤碼。
| 傳回碼 | 描述 |
|---|---|
|
解碼時發生錯誤。 |
|
找不到指定dwCertEncodingType和lpszStructType的解碼函式 |
|
如果 pvStructInfo 參數指定的緩衝區不夠大，無法保存傳回的資料，此函式會設定ERROR_MORE_DATA程式碼，並將所需的緩衝區大小以位元組為單位儲存在 由ERROR_MORE_DATA info指向的變數中。 |
如果函式失敗， GetLastError 可能會傳回 抽象語法標記法 1 (ASN.1) 編碼/解碼錯誤。 如需這些錯誤的相關資訊，請參閱 ASN.1 編碼/解碼傳回值。
備註
使用慣用 CryptEncodeObjectEx 函式編碼密碼編譯物件時，會包含終止 的 Null 字元。 解碼時，使用慣用 的 CryptDecodeObjectEx 函式，不會保留終止 的 Null 字元。
範例
如需使用此函式的範例，請參閱 範例 C 程式：ASN.1 編碼和解碼。
規格需求
| 最低支援的用戶端 | Windows XP [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | Windows Server 2003 [傳統型應用程式 |UWP 應用程式] |
| 目標平台 | Windows |
| 標頭 | wincrypt.h |
| 程式庫 | Crypt32.lib |
| Dll | Crypt32.dll |