VTableProvStruc 구조체

VTableProvStruc 구조에는 CSP(암호화 서비스 공급자) 함수에서 사용할 수 있는 콜백 함수에 대한 포인터가 포함되어 있습니다.

구문

typedef struct VTableProvStruc {
  DWORD   Version;
  FARPROC FuncVerifyImage;
  FARPROC FuncReturnhWnd;
  DWORD   dwProvType;
  BYTE    *pbContextInfo;
  DWORD   cbContextInfo;
  LPSTR   pszProvName;
} VTableProvStruc, *PVTableProvStruc;

구성원

버전

구조체의 버전을 나타내는 DWORD 값입니다. 이 구조체의 세 가지 버전이 사용됩니다. 버전은 숫자 1, 2 및 3이며 구조체의 멤버가 유효한지 확인합니다. 버전 1 멤버는 이 구조를 지원하는 모든 시스템에서 유효합니다.

버전 1 멤버입니다.

FuncVerifyImage

CSP가 CSP에서 로드할 DLL의 서명을 확인하는 데 사용하는 FuncVerifyImage 콜백 함수의 주소입니다. CSP가 함수를 호출하는 모든 보조 DLL은 기본 CSP DLL과 동일한 방식으로(및 동일한 키로) 서명되어야 합니다. 이 서명을 보장하려면 LoadLibrary 함수를 사용하여 보조 DLL을 동적으로 로드해야 합니다. 그러나 DLL을 로드하기 전에 DLL의 서명을 확인해야 합니다. CSP는 아래 예제와 같이 FuncVerifyImage 함수를 호출하여 이 확인을 수행합니다.

이 함수 포인터는 CSP 컨텍스트가 해제될 때까지 저장하고 사용할 수 있습니다.

버전 1 멤버입니다.

FuncReturnhWnd

CSP가 표시되는 사용자 인터페이스의 부모 또는 소유자로 사용해야 하는 창 핸들을 반환하는 FuncReturnhWnd 콜백 함수의 주소입니다. 이 용도로 전용 하드웨어를 사용하는 사용자 및 CSP와 직접 통신하지 않는 CSP는 이 항목을 무시할 수 있습니다. 이 창 핸들은 기본적으로 0이지만 애플리케이션은 CryptSetProvParam 함수를 사용하여 PP_CLIENT_HWND 속성을 설정하여 이 값을 다른 값으로 설정할 수 있습니다.

이 함수 포인터는 CSP 컨텍스트가 해제될 때까지 저장하고 사용할 수 있습니다.

버전 1 멤버입니다.

dwProvType

획득할 공급자의 유형을 지정하는 DWORD 값입니다. 다음 공급자 유형 은 미리 정의되어 있으며 CSP 상호 운용성에서 자세히 설명합니다.

• PROV_RSA_FULL
• PROV_RSA_SIG
• PROV_DSS
• PROV_FORTEZZA
• PROV_MS_EXCHANGE

버전 2 멤버입니다.

pbContextInfo

컨텍스트 정보 배열에 대한 포인터입니다. pbContextInfo 및 cbContextInfo 멤버는 CPSetProvParam 함수가 PP_CONTEXT_INFO 집합으로 호출되는 경우 사용되는 정보 집합을 결정합니다.

버전 2 멤버입니다.

cbContextInfo

pbContextInfo 배열의 요소 수를 나타내는 DWORD 값입니다.

버전 2 멤버입니다.

pszProvName

공급자의 이름을 포함하는 문자열입니다.

버전 3 멤버입니다.

설명

VTableProvStruc 구조체의 포인터는 CPAcquireContext 함수 내에서만 사용할 수 있습니다. CPAcquireContext 호출이 완료된 후 구조체의 멤버가 필요한 경우 CSP에서 필요한 구조 요소의 복사본을 만들어야 합니다. 이 구조체의 함수 포인터는 CSP 컨텍스트가 해제될 때까지 저장하고 사용할 수 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
헤더	Cspdk.h
유니코드 및 ANSI 이름	VTableProvStrucW (유니코드)