VTableProvStruc-Struktur

Die VTableProvStruc-Struktur enthält Zeiger auf Rückruffunktionen, die von CSP-Funktionen ( Cryptographic Service Provider ) 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. Es werden drei Versionen dieser Struktur verwendet. Die Versionen sind Nummer 1, 2 und 3 und bestimmen, welche Elemente der Struktur gültig sind. Member der Version 1 sind auf allen Systemen gültig, die diese Struktur unterstützen.

Dies ist ein Member der Version 1.

FuncVerifyImage

Die Adresse einer FuncVerifyImage-Rückruffunktion , die der CSP verwendet, um die Signatur aller DLLs zu überprüfen, die der CSP lädt. Alle Hilfs-DLLs, in die ein CSP Funktionsaufrufe durchführt, 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 mithilfe der LoadLibrary-Funktion dynamisch geladen werden. Bevor die DLL jedoch geladen wird, muss die Signatur der DLL ü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 Member der Version 1.

FuncReturnhWnd

Die Adresse einer FuncReturnhWnd-Rückruffunktion , die das Fensterhandle zurückgibt, das der CSP als übergeordnetes Element oder Besitzer einer angezeigten Benutzeroberfläche verwenden soll. CSPs, die nicht direkt mit dem Benutzer kommunizieren, und CSPs, die dedizierte Hardware für diesen Zweck verwenden, können diesen Eintrag ignorieren. Dieses Fensterhandle ist standardmäßig 0, aber eine Anwendung kann diesen Wert auf einen anderen Wert festlegen, indem sie die CryptSetProvParam-Funktion verwendet, um die PP_CLIENT_HWND-Eigenschaft festzulegen.

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

Dies ist ein Member der Version 1.

dwProvType

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

• PROV_RSA_FULL
• PROV_RSA_SIG
• PROV_DSS
• PROV_FORTEZZA
• PROV_MS_EXCHANGE

Dies ist ein Member der Version 2.

pbContextInfo

Ein Zeiger auf ein Array von Kontextinformationen. Die Elemente pbContextInfo und cbContextInfo bestimmen zusammen den Informationssatz, der verwendet wird, wenn eine CPSetProvParam-Funktion mit PP_CONTEXT_INFO festgelegt wird.

Dies ist ein Member der Version 2.

cbContextInfo

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

Dies ist ein Member der Version 2.

pszProvName

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

Dies ist ein Member der Version 3.

Bemerkungen

Die Zeiger in der VTableProvStruc-Struktur sind nur in der CPAcquireContext-Funktion verfügbar. Wenn Elemente der Struktur benötigt werden, nachdem ein Aufruf von CPAcquireContext abgeschlossen wurde, 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.

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)