ICEnroll3：：GetAlgName 方法 (xenroll.h)
[此方法已不再可供 Windows Server 2008 和 Windows Vista 使用。]
GetAlgName 方法會擷取指定其標識碼的密碼編譯演算法名稱。 此方法擷取的值取決於目前的 密碼編譯服務提供者 (CSP) 。 這個方法最初是在 ICEnroll3 介面中定義。
語法
HRESULT GetAlgName(
[in] LONG algID,
[out] BSTR *pbstr
);
參數
[in] algID
值，表示 Wincrypt.h 中所定義的密碼編譯演算法。 例如，CALG_MD2是定義的演算法識別碼。 若要讓這個方法成功，目前的 CSP 必須支援 algID 演算法。
[out] pbstr
成功時，代表 algID 所指定演算法名稱的 BSTR 指標。 當您完成 使用 BSTR 時，請藉由呼叫 SysFreeString 函式 來釋放它。
傳回值
C++
傳回值為 HRESULT。 值S_OK表示成功。 如果 CSP 不支援此方法或不支援 algID 密碼編譯演算法，則會傳回錯誤。VB
傳回值是代表 algID 所指定演算法名稱的字串。 如果 CSP 不支援此方法，則會傳回錯誤。備註
這個方法可用來顯示其標識符擷取的演算法名稱，方法是呼叫 EnumAlgs。
密碼編譯演算法的常數定義於 Wincrypt.h 中。
範例
BSTR bstrAlgName = NULL;
HRESULT hr;
// Retrieve the algorithm name.
// dwAlgID is a DWORD variable for an algorithm ID.
hr = pEnroll->GetAlgName( dwAlgID, &bstrAlgName);
if (FAILED(hr))
printf("Failed GetAlgName [%x]\n", hr);
else
printf("AlgID: %d Name: %S\n", dwAlgID, bstrAlgName );
// Free BSTR resource.
if ( NULL != bstrAlgName )
{
SysFreeString( bstrAlgName );
bstrAlgName = NULL;
}
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | xenroll.h |
| 程式庫 | Uuid.lib |
| Dll | Xenroll.dll |