ICEnroll3::GetAlgName 메서드(xenroll.h)

[이 메서드는 Windows Server 2008 및 Windows Vista를 기준으로 더 이상 사용할 수 없습니다.]

GetAlgName 메서드는 ID가 지정된 암호화 알고리즘의 이름을 검색합니다. 이 메서드에서 검색한 값은 현재 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를 호출하여 ID를 검색하는 알고리즘의 이름을 표시하는 데 사용할 수 있습니다.

암호화 알고리즘에 대한 상수는 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

추가 정보

CEnroll

EnumAlgs

ICEnroll3

ICEnroll4