ICEnroll3：：GetSupportedKeySpec 方法 (xenroll.h)

[此方法已不再可供 Windows Server 2008 和 Windows Vista 使用。]

GetSupportedKeySpec 方法會擷取有關目前密碼編譯服務提供者的資訊， (CSP) 支援簽章和/或交換作業。 這個方法最初是在 ICEnroll3 介面中定義。

此方法所擷取的值取決於目前的 CSP。

語法

HRESULT GetSupportedKeySpec(
  [out] LONG *pdwKeySpec
);

參數

[out] pdwKeySpec

LONG 的指標，可接收位旗標，指出目前的 CSP 是否支援交換和簽章密鑰。

傳回值

C++

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

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

VB

傳回值，指出目前的 CSP 是否支援交換和簽章金鑰。 如果 CSP 不支援此方法，則會傳回錯誤。

備註

呼叫這個方法，以判斷目前的 CSP 是否支援交換金鑰、簽章密鑰或兩者。 pdwKeySpec 參數將包含下列一或多個常數， (定義於 Wincrypt.h) ：

• AT_KEYEXCHANGE
• AT_SIGNATURE

範例

DWORD dwKeySpec;

// Determine the supported key specifications.
// hr is HRESULT variable.
hr = pEnroll->GetSupportedKeySpec( &dwKeySpec );
if ( FAILED( hr ) )    
    printf("Failed GetSupportedKeySpec [%x]\n", hr);
else
{
    printf("Exchange keys are %s. Signature keys are %s.\n",
           dwKeySpec & AT_KEYEXCHANGE ? "supported" : "not supported",
           dwKeySpec & AT_SIGNATURE ? "supported" : "not supported" );
}

規格需求

需求	值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
目標平台	Windows
標頭	xenroll.h
程式庫	Uuid.lib
Dll	Xenroll.dll

另請參閱

CEnroll

ICEnroll3

ICEnroll4