ICEnroll4::GetKeyLenEx 메서드(xenroll.h)

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

GetKeyLenEx 메서드는 서명 및 교환 키에 대한 크기 정보를 검색합니다. 이 메서드는 ICEnroll4 인터페이스에서 처음 정의되었습니다.

이 메서드에서 검색한 값은 현재 CSP( 암호화 서비스 공급자 )에 따라 달라집니다.

구문

HRESULT GetKeyLenEx(
  [in]  LONG lSizeSpec,
  [in]  LONG lKeySpec,
  [out] LONG *pdwKeySize
);

매개 변수

[in] lSizeSpec

검색할 크기 정보의 유형을 나타내는 값입니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

의미
XEKL_KEYSIZE_MIN
최소 키 크기입니다.
XEKL_KEYSIZE_MAX
최대 키 크기입니다.
XEKL_KEYSIZE_INC
키 증분 크기입니다. 자세한 내용은 설명 부분을 참조하세요.

[in] lKeySpec

크기 정보가 반환되는 키를 지정합니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

의미
XEKL_KEYSPEC_KEYX
Exchange 키
XEKL_KEYSPEC_SIG
서명 키

[out] pdwKeySize

키 크기를 비트 단위로 수신하는 변수에 대한 포인터입니다.

반환 값

C++

메서드가 성공하면 메서드는 S_OK 반환합니다.

메서드가 실패하면 오류를 나타내는 HRESULT 값이 반환됩니다. 일반적인 오류 코드 목록은 일반적인 HRESULT 값을 참조하세요.

VB

키 크기를 비트 단위로 나타내는 값입니다.

설명

CSP가 이 메서드를 지원하지 않으면 오류가 반환됩니다.

XEKL_KEYSIZE_INC 값에 대한 자세한 내용은 CryptGetProvParam 참조 페이지의 PP_SIG_KEYSIZE_INC 사용량을 참조하세요.

예제

DWORD dwExchMin, dwExchMax, dwSignDef, dwSignInc;

// Determine the minimum and maximum key length values.
// hr is HRESULT variable.
hr = pEnroll4->GetKeyLenEx( XEKL_KEYSIZE_MIN,
                            XEKL_KEYSPEC_KEYX,
                            &dwExchMin );
if ( FAILED( hr ) )    
    printf("Failed GetKeyLenEx for Exchange Minimum [%x]\n", hr);
else
    printf("Exchange key Min: %d\n", dwExchMin);

hr = pEnroll4->GetKeyLenEx( XEKL_KEYSIZE_MAX,
                            XEKL_KEYSPEC_KEYX,
                            &dwExchMax );
if ( FAILED( hr ) )
    printf("Failed GetKeyLenEx for Exchange Maximum [%x]\n", hr);
else
    printf("Exchange key Max: %d\n", dwExchMax );

hr = pEnroll4->GetKeyLenEx( XEKL_KEYSIZE_DEFAULT,
                            XEKL_KEYSPEC_SIG,
                            &dwSignDef );
if ( FAILED( hr ) )
    printf("Failed GetKeyLenEx for Signature Default "
   "Key size [%x]\n", hr);
else
    printf("Signature key default size: %d\n", dwSignDef );

hr = pEnroll4->GetKeyLenEx( XEKL_KEYSIZE_INC,
                            XEKL_KEYSPEC_SIG,
                            &dwSignInc );
if ( FAILED( hr ) )    
    printf("Failed GetKeyLenEx for Signature "
   "Key Size Increment [%x]\n", hr);
else
    printf("Signature key increment size: %d\n", dwSignInc );

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 xenroll.h
라이브러리 Uuid.lib
DLL Xenroll.dll