VTableProvStruc 結構

VTableProvStruc結構包含回呼函式的指標，這些函式可由密碼編譯服務提供者 (CSP) 函式使用。

語法

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

成員

版本

指出 結構的 DWORD值。 使用這個 結構的三個版本。 版本是數位 1、2 和 3，並判斷結構的哪些成員有效。 第 1 版成員在所有支援此結構的系統上都是有效的。

這是第 1 版成員。

FuncVerifyImage

CSP 用來驗證 CSP 將載入之任何 DLL 簽章的 FuncVerifyImage 回呼函式位址。 CSP 發出函式呼叫的所有輔助 DLL 都必須以相同的方式簽署 (，且金鑰) 與主要 CSP DLL 相同。 若要確保此簽章，必須使用 LoadLibrary 函式動態載入輔助 DLL。 但在載入 DLL 之前，必須驗證 DLL 的簽章。 CSP 會藉由呼叫 FuncVerifyImage 函式來執行這項驗證，如下列範例所示。

此函式指標可以儲存及使用，直到 CSP 內容釋放為止。

這是第 1 版成員。

FuncReturnhWnd

FuncReturnhWnd回呼函式的位址，此函式會傳回 CSP 應該用來做為所顯示之任何使用者介面的父代或擁有者之視窗控制碼。 未直接與使用者通訊的 CSP 和使用此用途專用硬體的 CSP 可以忽略此專案。 此視窗控制碼預設為零，但應用程式可以使用 CryptSetProvParam 函式來設定 PP_CLIENT_HWND 屬性，將此設定為不同的值。

此函式指標可以儲存及使用，直到 CSP 內容釋放為止。

這是第 1 版成員。

dwProvType

DWORD值，指定要取得的提供者類型。 下列 提供者類型 是預先定義的，並在 CSP 互通性中詳細討論：

• PROV_RSA_FULL
• PROV_RSA_SIG
• PROV_DSS
• PROV_FORTEZZA
• PROV_MS_EXCHANGE

這是第 2 版成員。

pbCoNtextInfo

內容資訊的陣列指標。 pbCoNtextInfo和cbCoNtextInfo成員會一起決定使用 PP_CONTEXT_INFO set 呼叫CPSetProvParam函式時所使用的資訊集。

這是第 2 版成員。

cbCoNtextInfo

DWORD值，表示pbCoNtextInfo陣列中的專案數目。

這是第 2 版成員。

pszProvName

包含提供者名稱的字串。

這是第 3 版成員。

備註

VTableProvStruc結構中的指標只能在CPAcquireCoNtext函式中使用。 如果在 呼叫 CPAcquireCoNtext 完成之後需要結構的成員，CSP 必須製作所需結構元素的複本。 這個結構中的函式指標可以儲存並使用，直到釋放 CSP 內容為止。

規格需求

需求	值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限桌面應用程式]
標頭	Cspdk.h
Unicode 與 ANSI 名稱	VTableProvStrucW (Unicode)