PFN_CRYPT_EXTRACT_ENCODED_SIGNATURE_PARAMETERS_FUNC回呼函式 (wincrypt.h)

如果簽章包含編碼的參數， 則會呼叫PFN_CRYPT_EXTRACT_ENCODED_SIGNATURE_PARAMETERS_FUNC 回呼函式來譯碼並傳回哈希演算法標識碼，並選擇性地傳回簽章參數。

語法

PFN_CRYPT_EXTRACT_ENCODED_SIGNATURE_PARAMETERS_FUNC PfnCryptExtractEncodedSignatureParametersFunc;

BOOL PfnCryptExtractEncodedSignatureParametersFunc(
  [in]            DWORD dwCertEncodingType,
  [in]            PCRYPT_ALGORITHM_IDENTIFIER pSignatureAlgorithm,
  [out, optional] void **ppvDecodedSignPara,
  [out]           LPWSTR *ppwszCNGHashAlgid
)
{...}

參數

[in] dwCertEncodingType

指定使用的編碼類型。 將憑證和 訊息編碼類型 與位 OR 作業結合在一起，一律可以接受，如下列範例所示：

X509_ASN_ENCODING |PKCS_7_ASN_ENCODING目前定義的編碼類型如下：

• X509_ASN_ENCODING
• PKCS_7_ASN_ENCODING

[in] pSignatureAlgorithm

包含簽章對象標識碼 (OID) 及其選擇性編碼參數之CRYPT_ALGORITHM_IDENTIFIER結構的指標。

[out, optional] ppvDecodedSignPara

已譯碼和配置之簽章參數數據結構的位址指標。 傳回譯碼的緩衝區是選擇性的。

[out] ppwszCNGHashAlgid

所配置 Unicode 字串的位址指標，表示從編碼簽章參數擷取的 CNG 哈希演算法識別碼。 如果此函式傳回 TRUE，則必須傳回非 NULL 指標。

傳回值

如果函式成功，函式會傳回非零 (TRUE) 。

如果函式失敗，它會傳回零 (FALSE) 。 如需擴充錯誤資訊，請呼叫 GetLastError。

如果此回呼函式不支援簽章演算法，則必須傳回 FALSE，並使用 ERROR_NOT_SUPPORTED呼叫 SetLastError。

備註

ppvDecodedSignPara 和 ppwszCNGHashAlgid 參數的記憶體必須使用 LocalAlloc 函式來配置。

您可以使用 OID 支援函式 來部署此回呼函式。 Wincrypt.h 會為此目的定義下列常數。

常數	定義
CRYPT_OID_EXTRACT_ENCODED_SIGNATURE_PARAMETERS_FUNC	“CryptDllExtractEncodedSignatureParameters”

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
目標平台	Windows
標頭	wincrypt.h