WSCInstallNameSpace32 函式 (ws2spi.h)
WSCInstallNameSpace32 函式會安裝指定的 32 位命名空間提供者。 對於能夠支援多個命名空間的提供者，每個支援的命名空間都必須呼叫此函式，而且每次都必須提供唯一提供者標識符。
語法
INT WSCInstallNameSpace32(
[in] LPWSTR lpszIdentifier,
[in] LPWSTR lpszPathName,
[in] DWORD dwNameSpace,
[in] DWORD dwVersion,
[in] LPGUID lpProviderId
);
參數
[in] lpszIdentifier
字串的指標，識別與 lpProviderId 參數中傳遞之 GUI) D (全域唯一標識符相關聯的提供者。
[in] lpszPathName
字串的指標，其中包含提供者 DLL 映像的路徑。 字串會觀察路徑解析的一般規則：此路徑可以包含內嵌的環境字串 (，例如 %SystemRoot%) 。 每當 WS2_32.DLL 必須代表應用程式載入提供者 DLL 時，就會展開這類環境字串。 展開任何內嵌的環境字串之後，Ws2_32.dll 會將產生的字串傳遞至 LoadLibrary 函式，以將提供者載入記憶體中。 如需詳細資訊，請參閱 LoadLibrary。
[in] dwNameSpace
描述項，指定這個提供者支援的命名空間。
[in] dwVersion
指定提供者版本號碼的描述項。
[in] lpProviderId
這個提供者的唯一標識符。 此 GUID 應該由 Uuidgen.exe 產生。
傳回值
如果沒有發生錯誤， WSCInstallNameSpace32 函式會傳回零NO_ERROR (零) 。 否則，如果函式失敗，它會傳回SOCKET_ERROR，而且您必須使用 WSAGetLastError 函式擷取適當的錯誤碼。
| 錯誤碼 | 意義 |
|---|---|
| 呼叫例程沒有足夠的許可權可安裝命名空間。 | |
| 一或多個引數無效。 | |
| 發生無法復原的錯誤。 此錯誤會在下列幾個情況下傳回：提供者已安裝、使用者缺少寫入 Winsock 登錄所需的系統管理許可權，或建立或安裝類別目錄專案時發生失敗。 | |
| 應該永遠不會失敗的系統呼叫失敗。 | |
| 記憶體不足。 當記憶體不足而無法配置新的目錄專案時，就會傳回此錯誤。 |
備註
WSCInstallNameSpace32 是嚴格 32 位版本的 WSCInstallNameSpace。 例如，在64位電腦上，所有呼叫並非特別為32位 (，在原生64位目錄上不會結束於 「32」) 的所有函式。 在 64 位電腦上執行的進程必須使用特定的 32 位函數調用，才能在嚴格 32 位目錄上運作，並保留相容性。 特定32位呼叫的定義和語意與其原生對應專案相同。
命名空間組態函式不會影響已執行的應用程式。 應用程式將不會看到新安裝的命名空間提供者，也不會顯示命名空間提供者啟用狀態中的變更。 呼叫 WSCInstallNameSpace32 之後啟動的應用程式將會辨識變更。
WSCInstallNameSpace32 函式只能由以 Administrators 群組成員身分登入的使用者呼叫。 如果 WSCInstallNameSpace32 是由不是 Administrators 群組成員的使用者呼叫，則函數調用將會失敗。 對於執行 Windows Vista 或 Windows Server 2008 的電腦，此函式也可能因為使用者帳戶控制 (UAC) 而失敗。 如果包含此函式的應用程式是由以內建系統管理員以外的 Administrators 群組成員身分登入的使用者所執行，除非應用程式已在指令清單檔案中標示 為 requestedExecutionLevel 設定為 requireAdministrator，否則此呼叫將會失敗。 如果 Windows Vista 或 Windows Server 2008 上的應用程式缺少此指令清單檔，則以系統管理員群組成員的身分登入的用戶必須接著在增強殼層中執行應用程式，因為內建的 Administrator (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 |