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 |
|
| Unicode- und ANSI-Name |
VTableProvStrucW (Unicode) |