| UID | title | description | helpviewer_keywords | old-location | tech.root | ms.assetid | ms.date | ms.keywords | req.header | req.include-header | req.target-type | req.target-min-winverclnt | req.target-min-winversvr | req.kmdf-ver | req.umdf-ver | req.ddi-compliance | req.unicode-ansi | req.idl | req.max-support | req.namespace | req.assembly | req.type-library | req.lib | req.dll | req.irql | targetos | req.typenames | req.redist | ms.custom | f1_keywords | dev_langs | topic_type | api_type | api_location | api_name | |||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
NF:ws2spi.WSCUnInstallNameSpace32 |
WSCUnInstallNameSpace32 function (ws2spi.h) |
Uninstalls a specific 32-bit namespace provider. |
|
winsock\wscuninstallnamespace32.htm |
WinSock |
a2a08159-6ac0-493d-8f9f-d19aa199a65f |
12/05/2018 |
WSCUnInstallNameSpace32, WSCUninstallNamespace32, WSCUninstallNamespace32 function [Winsock], winsock.wscuninstallnamespace32, ws2spi/WSCUninstallNamespace32 |
ws2spi.h |
Windows |
Windows Vista, Windows XP Professional x64 Edition [desktop apps only] |
Windows Server 2008, Windows Server 2003 x64 Edition [desktop apps only] |
Ws2_32.lib |
Ws2_32.dll |
Windows |
19H1 |
|
|
|
|
|
|
The WSCUnInstallNameSpace32 function uninstalls a specific 32-bit namespace provider.
A pointer to a globally unique identifier (GUID) for the name-space provider to be uninstalled.
If no error occurs, WSCUnInstallNameSpace32 returns NO_ERROR (zero). Otherwise, it returns SOCKET_ERROR if the function fails, and you must retrieve the appropriate error code using the WSAGetLastError function.
| Error code | Meaning |
|---|---|
| The lpProviderId parameter points to memory that is not in a valid part of the user address space. | |
| The specified namespace–provider identifier is invalid. | |
| A system call that should never fail has failed. | |
| Insufficient memory was available. This error is returned when there is insufficient memory to allocate a new catalog entry. |
WSCUnInstallNameSpace32 is a strictly 32-bit version of WSCUnInstallNameSpace. On a 64-bit computer, all calls not specifically 32-bit (for example, all functions that do not end in "32") operate on the native 64-bit catalog. Processes that execute on a 64-bit computer must use the specific 32-bit function calls to operate on a strictly 32-bit catalog and preserve compatibility. The definitions and semantics of the specific 32-bit calls are the same as their native counterparts.
The namespace configuration functions do not affect applications that are already running. Newly installed name-space providers will not be visible to applications nor will the changes in a name-space provider's activation state. Applications launched after the call to WSCUnInstallNameSpace32 will recognize the changes.
On success, WSCUnInstallNameSpace32 will attempt to alert all interested applications that have registered for notification of the change by calling WSAProviderConfigChange.
The WSCUnInstallNameSpace32 function can only be called by a user logged on as a member of the Administrators group. If WSCUnInstallNameSpace32 is called by a user that is not a member of the Administrators group, the function call will fail and WSANO_RECOVERY is returned in the lpErrno parameter.
For computers running on Windows Vista or Windows Server 2008, this function can also fail because of user account control (UAC). If an application that contains this function is executed by a user logged on as a member of the Administrators group other than the built-in Administrator, this call will fail unless the application has been marked in the manifest file with a requestedExecutionLevel set to requireAdministrator. If the application on Windows Vista or Windows Server 2008 lacks this manifest file, a user logged on as a member of the Administrators group other than the built-in Administrator must then be executing the application in an enhanced shell as the built-in Administrator (RunAs administrator) for this function to succeed.
The caller of this function must remove any additional files or service provider–specific configuration information that is required to completely uninstall the service provider.