VTableProvStruc-Struktur

Die VTableProvStruc-Struktur enthält Zeiger auf Rückruffunktionen, die von Kryptografiedienstanbieterfunktionen (Cryptographic Service Provider, 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;

Members

Version

Ein DWORD-Wert, der die Version der -Struktur angibt. Es werden drei Versionen dieser -Struktur verwendet. Die Versionen sind 1, 2 und 3 und bestimmen, welche Member der Struktur gültig sind. Member der Version 1 sind auf allen Systemen gültig, die diese Struktur unterstützen.

Dies ist ein Mitglied der Version 1.

FuncVerifyImage

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

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

Dies ist ein Mitglied der Version 1.

FuncReturnhWnd

Die Adresse einer FuncReturnhWnd-Rückruffunktion, die das Fensterhand handle zurückgibt, das der CSP als übergeordnetes Element oder Besitzer einer angezeigten Benutzeroberfläche verwenden soll. CSPs, die nicht direkt mit dem Benutzer und CSPs kommunizieren, die dedizierte Hardware für diesen Zweck verwenden, können diesen Eintrag ignorieren. Dieses Fensterhandli ist standardmäßig 0 (null), aber eine Anwendung kann dies auf einen anderen Wert festlegen, indem die CryptSetProvParam-Funktion zum Festlegen der PP CLIENT _ _ HWND-Eigenschaft verwendet wird.

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

Dies ist ein Mitglied der Version 1.

dwProvType

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

  • PROV _ RSA _ FULL
  • PROV _ RSA _ SIG
  • PROV _ DSS
  • PROV _ FORTEZZA
  • PROV _ MS _ EXCHANGE

Dies ist ein Mitglied der Version 2.

pbContextInfo

Ein Zeiger auf ein Array von Kontextinformationen. Die Member pbContextInfo und cbContextInfo bestimmen zusammen den Informationssatz, der verwendet wird, wenn eine CPSetProvParam-Funktion aufgerufen wird, für die PP _ CONTEXT INFO festgelegt _ ist.

Dies ist ein Mitglied der Version 2.

cbContextInfo

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

Dies ist ein Mitglied der Version 2.

pszProvName

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

Dies ist ein Mitglied der Version 3.

Bemerkungen

Die Zeiger in der VTableProvStruc-Struktur sind nur innerhalb der CPAcquireContext-Funktion verfügbar. Wenn Member der -Struktur benötigt werden, nachdem ein Aufruf von CPAcquireContext abgeschlossen wurde, müssen Kopien der erforderlichen Strukturelemente vom CSP vorgenommen werden. Die Funktionszeker in dieser Struktur können gespeichert und verwendet werden, bis der CSP-Kontext freigegeben wird.

Requirements (Anforderungen)

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