WSCGetProviderInfo32 函式 (ws2spi.h)

發行項
08/28/2023

**注意** 分層服務提供者已被取代。從 Windows 8 和 Windows Server 2012 開始，請使用 Windows 篩選平台。

**WSCGetProviderInfo32** 函式會擷取與 32 位分層服務提供者的資訊類別相關聯的資料， (LSP) 。

**注意** 此呼叫是嚴格 32 位版本的 WSCGetProviderInfo ，可用於 64 位平臺上。它提供來允許 64 位進程存取 32 位目錄。

語法

int WSCGetProviderInfo32(
  [in]      LPGUID                 lpProviderId,
  [in]      WSC_PROVIDER_INFO_TYPE InfoType,
  [out]     PBYTE                  Info,
  [in, out] size_t                 *InfoSize,
  [in]      DWORD                  Flags,
  [out]     LPINT                  lpErrno
);

參數

[in] lpProviderId

提供者的全域唯一識別碼指標 (GUID) 。

[in] InfoType

此 LSP 通訊協定專案要求的資訊類別。

[out] Info

緩衝區的指標，可接收所要求 LSP 通訊協定專案的資訊類別資料。如果此參數為 Null，則 WSCGetProviderInfo32 會傳回失敗，而且此緩衝區所需的大小會在 InfoSize 參數中傳回。

[in, out] InfoSize

Info參數所指向之緩衝區的大小，以位元組為單位。如果 Info 參數為 Null，則 WSCGetProviderInfo32 會傳回失敗， 而且 InfoSize 參數將會收到所需緩衝區的大小。

[in] Flags

用來修改 WSCGetProviderInfo32 函式呼叫行為的旗標。

[out] lpErrno

如果函式失敗，則為錯誤碼的指標。

傳回值

如果沒有發生錯誤， WSCGetProviderInfo32 會傳回 ERROR_SUCCESS ( 零) 。否則，它會傳回 SOCKET_ERROR，並在 lpErrno 參數中傳回特定的錯誤碼。

錯誤碼	意義
ERROR_CALL_NOT_IMPLEMENTED	不會實作呼叫。如果在 InfoType 參數中指定 ProviderInfoAudit，就會傳回此錯誤。
WSAEFAULT	一或多個引數不在使用者位址空間的有效部分。
WSAEINVAL	一或多個引數無效。
WSAEINVALIDPROVIDER	找不到指定之 lpProviderId的通訊協定專案。
WSANO_RECOVERY	發生無法復原的錯誤。此錯誤會在數個情況下傳回，包括下列情況：使用者缺少存取 Winsock 登錄所需的系統管理許可權，或開啟 Winsock 目錄專案時發生失敗。
WSA_NOT_ENOUGH_MEMORY	記憶體不足。當記憶體不足而無法配置新的目錄專案時，就會傳回此錯誤。

備註

WSCGetProviderInfo32 是嚴格 32 位版本的 WSCGetProviderInfo。在 64 位電腦上，所有呼叫並非特別 32 位 (，例如，不會以「32 ) 」結尾的所有函式都會在原生 64 位目錄上運作。在 64 位電腦上執行的處理常式必須使用特定的 32 位函式呼叫，以在嚴格 32 位目錄上運作，並保留相容性。特定 32 位呼叫的定義和語意與其原生對應專案相同。

WSCGetProviderInfo32 可用來擷取 32 位分層服務提供者上通訊協定專案的資訊類別資料。當 InfoType 參數設定為 ProviderInfoLspCategories時，成功 WSCGetProviderInfo32 會傳回 Info 參數，並將 Info 參數設定為 32 位 LSP 所實作的適當 LSP 類別旗標。

Winsock 2 可容納分層通訊協定。分層通訊協定是只實作較高層級通訊函式的通訊協定，同時依賴基礎傳輸堆疊來與遠端端點實際交換資料。分層通訊協定或分層服務提供者的範例是一個安全性層，可將通訊協定新增至連線建立程式，以執行驗證，並建立相互同意的加密配置。這類安全性通訊協定通常需要基礎可靠傳輸通訊協定的服務，例如 TCP 或 SPX。基底通訊協定一詞是指 TCP 或 SPX 等通訊協定，其能夠與遠端端點執行資料通訊。分層通訊協定一詞是用來描述無法獨立通訊協定的通訊協定。接著，通訊協定鏈結會定義為一或多個分層通訊協定，並依基底通訊協定錨定。基底通訊協定的 ChainLen 成員 WSAProtocol_Info結構設定為 1 BASE_PROTOCOL 。分層通訊協定的 ChainLen 成員 WSAPROTOCOL_INFO結構設定 為 LAYERED_PROTOCOL ，定義為零。通訊協定鏈結的 ChainLen 成員 WSAPROTOCOL_INFO結構設定 為大於 1。

在 LSP 初始化期間，LSP 必須提供一些 Winsock SPI 函式的指標。這些函式會在正常處理期間由 LSP 正上方的層呼叫， (另一個 LSP 或 Ws2_32.DLL) 。

實作可安裝檔案系統的 LSP (IFS) 可以選擇性地選擇提供本身實作之函式的指標，或傳回圖層直接在 LSP 下方提供的指標。非 IFS LSP，因為它們提供自己的控制碼，所以必須實作所有的 Winsock SPI 函式。這是因為每個 SPI 都需要 LSP 將它建立的所有通訊端控制碼對應至較低提供者的通訊端控制碼， (另一個 LSP 或基底通訊協定) 。

不過，所有 LSP 只要對 Winsock SPI 函式的子集執行額外的處理，即可執行其特定工作。

您可以根據 LSP 實作的 SPI 函式子集，以及針對每個函式執行的額外處理本質來定義 LSP 類別。

藉由分類 LSP，以及分類使用 Winsock 通訊端的應用程式，可以選擇性地判斷 LSP 是否應該在執行時間參與指定的進程。

在 Windows Vista 和更新版本上，LSP 可以根據它如何與 Windows Sockets 呼叫和資料互動來分類。 LSP 類別是 Winsock SPI 函式子集上可識別的行為群組。例如，HTTP 內容篩選會分類為數據偵測器， (LSP_INSPECTOR 類別目錄) 。 LSP_INSPECTOR類別會檢查資料傳輸 SPI 函式的參數，但不會改變參數。應用程式可以查詢 LSP 的類別，並選擇不要根據 LSP 類別和應用程式允許的 LSP 類別集載入 LSP。

下表列出可分類 LSP 的類別。

LSP 類別	描述
LSP_CRYPTO_COMPRESS	LSP 是密碼編譯或資料壓縮提供者。
LSP_FIREWALL	LSP 是防火牆提供者。
LSP_LOCAL_CACHE	LSP 是本機快取提供者。
LSP_INBOUND_MODIFY	LSP 會修改輸入資料。
LSP_INSPECTOR	LSP 會檢查或篩選資料。
LSP_OUTBOUND_MODIFY	LSP 會修改輸出資料。
LSP_PROXY	LSP 可作為 Proxy，並重新導向封包。
LSP_REDIRECTOR	LSP 是網路重新導向器。
LSP_SYSTEM	LSP 可用於服務和系統進程。

LSP 可能屬於多個類別。例如，防火牆/安全性 LSP 可能同時屬於偵測器 (LSP_INSPECTOR) 和防火牆 (LSP_FIREWALL) 類別。

如果 LSP 沒有類別目錄設定，則會被視為在 [所有其他] 類別中。此 LSP 類別不會載入服務或系統進程 (例如 lsass、winlogon 和許多 svchost 進程) 。

規格需求


最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
目標平台	Windows
標頭	ws2spi.h
程式庫	Ws2_32.lib
Dll	Ws2_32.dll