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++

VB

備註

這個方法可用來顯示其標識符擷取的演算法名稱，方法是呼叫 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;
}

規格需求

另請參閱

CEnroll

EnumAlgs

ICEnroll3

ICEnroll4