VTableProvStruc 結構

VTableProvStruc結構包含密碼編譯服務提供者 (雲端解決方案提供者) 函式可以使用的回呼函式指標。

語法

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

雲端解決方案提供者用來驗證雲端解決方案提供者將載入之任何 DLL 簽章的FuncVerifyImage回呼函式位址。 雲端解決方案提供者發出函式呼叫的所有輔助 DLL 都必須以相同的方式簽署 (,並使用與主要雲端解決方案提供者 DLL 相同的索引鍵) 。 若要確保此簽章,必須使用 LoadLibrary 函式動態載入輔助 DLL。 但在載入 DLL 之前,必須驗證 DLL 的簽章。 雲端解決方案提供者藉由呼叫FuncVerifyImage函式來執行此驗證,如下列範例所示。

此函式指標可以儲存和使用,直到發行雲端解決方案提供者內容為止。

這是第 1 版成員。

FuncReturnhWnd

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

此函式指標可以儲存和使用,直到發行雲端解決方案提供者內容為止。

這是第 1 版成員。

dwProvType

DWORD值,指定要取得的提供者類型。 下列提供者類型是預先定義的,並在互通性雲端解決方案提供者詳細討論:

  • PROV_RSA_FULL
  • PROV_RSA_SIG
  • PROV_DSS
  • PROV_FORTEZZA
  • PROV_MS_EXCHANGE

這是第 2 版成員。

pbCoNtextInfo

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

這是第 2 版成員。

cbCoNtextInfo

DWORD值,指出pbCoNtextInfo陣列中的元素數目。

這是第 2 版成員。

pszProvName

包含提供者名稱的字串。

這是第 3 版成員。

備註

VTableProvStruc結構中的指標只能在CPAcquireCoNtext函式中使用。 如果在呼叫CPAcquireCoNtext完成之後需要結構的成員,則必須由雲端解決方案提供者建立所需的結構元素複本。 此結構中的函式指標可以儲存及使用,直到釋放雲端解決方案提供者內容為止。

規格需求

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