Estrutura VTableProvStruc

A estrutura VTableProvStruc contém ponteiros para funções de retorno de chamada que podem ser usadas por funções CSP ( provedor de serviços criptográficos ).

Sintaxe

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

Membros

Versão

Um valor DWORD que indica a versão da estrutura. Três versões dessa estrutura são usadas. As versões são número 1, 2 e 3 e determinam quais membros da estrutura são válidos. Os membros da versão 1 são válidos em todos os sistemas que dão suporte a essa estrutura.

Este é um membro da versão 1.

FuncVerifyImage

O endereço de uma função de retorno de chamada FuncVerifyImage que o CSP usa para verificar a assinatura de quaisquer DLLs que o CSP carregará. Todas as DLLs auxiliares nas quais um CSP faz chamadas de função devem ser assinadas da mesma maneira (e com a mesma chave) que a DLL CSP primária. Para garantir essa assinatura, as DLLs auxiliares devem ser carregadas dinamicamente usando a função LoadLibrary . Mas antes que a DLL seja carregada, a assinatura da DLL deve ser verificada. O CSP executa essa verificação chamando a função FuncVerifyImage , conforme mostrado no exemplo abaixo.

Esse ponteiro de função pode ser armazenado e usado até que o contexto CSP seja liberado.

Este é um membro da versão 1.

FuncReturnhWnd

O endereço de uma função de retorno de chamada FuncReturnhWnd que retorna o identificador de janela que o CSP deve usar como pai ou proprietário de qualquer interface do usuário exibida. Os CSPs que não se comunicam diretamente com o usuário e os CSPs que usam hardware dedicado para essa finalidade podem ignorar essa entrada. Esse identificador de janela é zero por padrão, mas um aplicativo pode definir isso como um valor diferente usando a função CryptSetProvParam para definir a propriedade PP_CLIENT_HWND .

Esse ponteiro de função pode ser armazenado e usado até que o contexto CSP seja liberado.

Este é um membro da versão 1.

Dwprovtype

Um valor DWORD que especifica o tipo de provedor a ser adquirido. Os seguintes tipos de provedor são predefinidos e são discutidos detalhadamente na interoperabilidade do CSP:

• PROV_RSA_FULL
• PROV_RSA_SIG
• PROV_DSS
• PROV_FORTEZZA
• PROV_MS_EXCHANGE

Este é um membro da versão 2.

pbContextInfo

Um ponteiro para uma matriz de informações de contexto. Os membros pbContextInfo e cbContextInfo juntos determinam o conjunto de informações usado quando uma função CPSetProvParam é chamada com PP_CONTEXT_INFO definido.

Este é um membro da versão 2.

cbContextInfo

Um valor DWORD que indica o número de elementos na matriz pbContextInfo .

Este é um membro da versão 2.

pszProvName

Uma cadeia de caracteres que contém o nome do provedor.

Este é um membro da versão 3.

Comentários

Os ponteiros na estrutura VTableProvStruc só estão disponíveis na função CPAcquireContext . Se os membros da estrutura forem necessários após a conclusão de uma chamada para CPAcquireContext , as cópias dos elementos de estrutura necessários deverão ser feitas pelo CSP. Os ponteiros de função nessa estrutura podem ser armazenados e usados até que o contexto CSP seja liberado.

Requisitos