WSCUpdateProvider32 函式 (ws2spi.h)

發行項
03/04/2024

WSCUpdateProvider32 函式會修改系統組態資料庫中指定的 32 位傳輸提供者。

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

語法

int WSCUpdateProvider32(
  [in]  LPGUID                    lpProviderId,
  [in]  const WCHAR               *lpszProviderDllPath,
  [in]  const LPWSAPROTOCOL_INFOW lpProtocolInfoList,
  [in]  DWORD                     dwNumberOfEntries,
  [out] LPINT                     lpErrno
);

參數

[in] lpProviderId

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

[in] lpszProviderDllPath

Unicode 字串的指標，其中包含提供者 64 位 DLL 的載入路徑。此字串會觀察路徑解析的一般規則，而且可以包含內嵌的環境字串 (，例如 %SystemRoot%) 。當 Ws2_32.dll 之後必須代表應用程式載入提供者 DLL 時，就會展開這類環境字串。展開任何內嵌的環境字串之後，Ws2_32.dll 會將產生的字串傳遞至 LoadLibrary 函式，以將提供者載入記憶體中。如需詳細資訊，請參閱 LoadLibrary。

[in] lpProtocolInfoList

WSAProtocol_Info 結構的陣列指標。每個結構都會指定或修改提供者支援的通訊協議、位址系列和套接字類型。

[in] dwNumberOfEntries

lpProtocolInfoList 陣列中的項目數目。

[out] lpErrno

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

傳回值

如果沒有發生錯誤， WSCUpdateProvider32 會傳回零。否則，它會傳回SOCKET_ERROR，而且 lpErrno 中提供特定的錯誤碼。

錯誤碼	意義
WSAEFAULT	一或多個自變數不在用戶位址空間的有效部分。
WSAEINVAL	一或多個引數無效。
WSANO_RECOVERY	發生無法復原的錯誤。此錯誤會在數個情況下傳回，包括下列情況：使用者缺少寫入 Winsock 登錄所需的系統管理許可權，或在開啟或寫入目錄專案時發生失敗。
WSA_NOT_ENOUGH_MEMORY	記憶體不足。當記憶體不足而無法配置新的目錄專案時，就會傳回此錯誤。

備註

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

此函式會修改指定之 32 位提供者的 Windows Sockets 2 組態資訊。它適用於基底通訊協定、分層通訊協定和通訊協定鏈結。

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

成功時， WSCUpdateProvider32 會透過呼叫 WSAProviderConfigChange，嘗試警示已註冊變更通知的所有相關應用程式。

只有以 Administrators 群組成員身分登入的使用者，才能呼叫 WSCUpdateProvider32 函式。如果 WSCUpdateProvider32 是由不是 Administrators 群組成員的使用者呼叫，函式呼叫將會失敗。

對於執行 Windows Vista 或 Windows Server 2008 的電腦，此函式也可能因為使用者帳戶控制 (UAC) 而失敗。如果包含此函式的應用程式是由使用者以系統管理員以外的系統管理員群組成員身分登入來執行，除非應用程式已在指令清單檔中標示為 requestedExecutionLevel 設定為 requireAdministrator，否則此呼叫將會失敗。如果 Windows Vista 或 Windows Server 2008 上的應用程式缺少此指令清單檔案，則使用者以系統管理員以外的系統管理員群組成員身分登入，則必須在增強的殼層中執行應用程式，因為內建系統管理員 (RunAs 系統管理員) ，才能讓此函式成功。

呼叫端必須執行任何檔案安裝或服務提供者特定的組態。

規格需求

需求	值
最低支援的用戶端	Windows Vista、Windows XP Professional x64 Edition [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008、Windows Server 2003 x64 Edition [僅限桌面應用程式]
目標平台	Windows
標頭	ws2spi.h
程式庫	Ws2_32.lib
Dll	Ws2_32.dll