VTableProvStruc-Struktur

Die VTableProvStruc-Struktur enthält Zeiger auf Rückruffunktionen, die von kryptografischen Dienstanbieterfunktionen (CSP) verwendet werden können.

Syntax

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

Member

Version

Ein DWORD-Wert , der die Version der Struktur angibt. Drei Versionen dieser Struktur werden verwendet. Die Versionen sind Nummer 1, 2 und 3 und bestimmen, welche Elemente der Struktur gültig sind. Version 1-Mitglieder sind für alle Systeme gültig, die diese Struktur unterstützen.

Dies ist ein Mitglied von Version 1.

FuncVerifyImage

Die Adresse einer FuncVerifyImage-Rückruffunktion , die der CSP verwendet, um die Signatur aller DLLs zu überprüfen, die der CSP geladen wird. Alle Hilfs-DLLs, in denen ein CSP Funktionsaufrufe durchführt, müssen auf dieselbe Weise (und mit demselben Schlüssel) wie die primäre CSP-DLL angemeldet werden. Um diese Signatur sicherzustellen, muss die Hilfs-DLLs dynamisch mithilfe der LoadLibrary-Funktion geladen werden. Bevor die DLL geladen wird, muss die Signatur der DLL jedoch überprüft werden. Der CSP führt diese Überprüfung durch Aufrufen der FuncVerifyImage-Funktion aus, wie im folgenden Beispiel gezeigt.

Dieser Funktionszeiger kann gespeichert und verwendet werden, bis der CSP-Kontext freigegeben wird.

Dies ist ein Mitglied von Version 1.

FuncReturnhWnd

Die Adresse einer FuncReturnhWnd-Rückruffunktion , die den Fensterhandpunkt zurückgibt, den der CSP als übergeordneter oder Besitzer einer benutzeroberfläche verwenden sollte, die angezeigt wird. CSPs, die nicht direkt mit dem Benutzer und csPs kommunizieren, die dedizierte Hardware für diesen Zweck verwenden, können diesen Eintrag ignorieren. Dieser Fensterhandpunkt ist standardmäßig null, aber eine Anwendung kann dies auf einen anderen Wert festlegen, indem Sie die Funktion "CryptSetProvParam " verwenden, um die PP_CLIENT_HWND-Eigenschaft festzulegen.

Dieser Funktionszeiger kann gespeichert und verwendet werden, bis der CSP-Kontext freigegeben wird.

Dies ist ein Mitglied von Version 1.

dwProvType

Ein DWORD-Wert , der den Typ des zu erwerbenden Anbieters angibt. Die folgenden Anbietertypen sind vordefinierte und werden ausführlich in der CSP-Interoperabilität erläutert:

  • PROV_RSA_FULL
  • PROV_RSA_SIG
  • PROV_DSS
  • PROV_FORTEZZA
  • PROV_MS_EXCHANGE

Dies ist ein Version 2-Mitglied.

pbContextInfo

Ein Zeiger auf ein Array von Kontextinformationen. Die Mitglieder " pbContextInfo " und "cbContextInfo " bestimmen gemeinsam den Informationssatz, der verwendet wird, wenn eine CPSetProvParam-Funktion mit PP_CONTEXT_INFO Satz aufgerufen wird.

Dies ist ein Version 2-Mitglied.

cbContextInfo

Ein DWORD-Wert , der die Anzahl der Elemente im PbContextInfo-Array angibt.

Dies ist ein Version 2-Mitglied.

pszProvName

Eine Zeichenfolge, die den Namen des Anbieters enthält.

Dies ist ein Version 3-Mitglied.

Bemerkungen

Die Zeiger in der VTableProvStruc-Struktur sind nur in der CPAcquireContext-Funktion verfügbar. Wenn Elemente der Struktur nach Abschluss eines Aufrufs von CPAcquireContext benötigt werden, müssen Kopien der erforderlichen Strukturelemente vom CSP erstellt werden. Die Funktionszeiger in dieser Struktur können gespeichert und verwendet werden, bis der CSP-Kontext freigegeben wird.

Requirements (Anforderungen)

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Server 2003 [nur Desktop-Apps]
Header
Cspdk.h
Unicode- und ANSI-Name
VTableProvStrucW (Unicode)