WSCUnInstallNameSpace 函式 (ws2spi.h)
WSCUnInstallNameSpace 函式會卸載指定的名稱空間提供者。
語法
INT WSCUnInstallNameSpace(
[in] LPGUID lpProviderId
);
參數
[in] lpProviderId
要卸載之名稱空間提供者的全域唯一標識符指標 (GUID) 。
傳回值
如果沒有發生錯誤， WSCUnInstallNameSpace 會傳回 NO_ERROR ( 零) 。 否則，如果函式失敗，則會傳回 SOCKET_ERROR ，而且您必須使用 WSAGetLastError 函式擷取適當的錯誤碼。
| 錯誤碼 | 意義 |
|---|---|
| lpProviderId 參數指向不在使用者位址空間有效部分的記憶體。 | |
| 指定的命名空間提供者識別碼無效。 | |
| 不應該失敗的系統呼叫失敗。 | |
| 記憶體不足。 當記憶體不足而無法配置新的目錄專案時，就會傳回此錯誤。 |
備註
命名空間組態函式不會影響已經執行的應用程式。 應用程式不會看到新安裝的名稱空間提供者，也不會顯示名稱空間提供者啟用狀態的變更。 呼叫 WSCUnInstallNameSpace 之後啟動的應用程式將會看到變更。
成功時， WSCUnInstallNameSpace 會透過呼叫 WSAProviderConfigChange，嘗試警示已註冊變更通知的所有相關應用程式。
WSCUnInstallNameSpace 函式只能由以 Administrators 群組成員身分登入的使用者呼叫。 如果 WSCUnInstallNameSpace 是由不是 Administrators 群組成員的使用者呼叫，則函式呼叫將會失敗，並在 lpErrno 參數中傳回WSANO_RECOVERY。
對於在 Windows Vista 或 Windows Server 2008 上執行的電腦，此函式也可能因為使用者帳戶控制 (UAC) 而失敗。 如果包含此函式的應用程式是由使用者以系統管理員以外的系統管理員群組成員身分登入來執行，除非應用程式已在指令清單檔中標示為 requestedExecutionLevel 設定為 requireAdministrator，否則此呼叫將會失敗。 如果 Windows Vista 或 Windows Server 2008 上的應用程式缺少此指令清單檔案，則使用者以系統管理員以外的系統管理員群組成員身分登入，則必須在增強的殼層中執行應用程式，因為內建系統管理員 (RunAs 系統管理員) ，此函式才能成功。
此函式的呼叫端必須移除任何其他檔案或服務提供者特定的組態資訊，才能完全卸載服務提供者。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | ws2spi.h |
| 程式庫 | Ws2_32.lib |
| Dll | Ws2_32.dll |