Función WSCUnInstallNameSpace (ws2spi.h)

  • Artículo

La función WSCUnInstallNameSpace desinstala el proveedor de espacio de nombres indicado.

Sintaxis

INT WSCUnInstallNameSpace(
  [in] LPGUID lpProviderId
);

Parámetros

[in] lpProviderId

Puntero a un identificador único global (GUID) para que se desinstale el proveedor de espacio de nombres.

Valor devuelto

Si no se produce ningún error, WSCUnInstallNameSpace devuelve NO_ERROR (cero). De lo contrario, devuelve SOCKET_ERROR si se produce un error en la función y debe recuperar el código de error adecuado mediante la función WSAGetLastError .

Código de error Significado
WSAEFAULT
 El parámetro lpProviderId apunta a la memoria que no está en una parte válida del espacio de direcciones del usuario.
WSAEINVAL
 El identificador del proveedor del espacio de nombres especificado no es válido.
WSASYSCALLFAILURE
 Se ha producido un error en una llamada del sistema que nunca debería producir un error.
WSA_NOT_ENOUGH_MEMORY
 Memoria insuficiente disponible. Este error se devuelve cuando no hay memoria suficiente para asignar una nueva entrada de catálogo.

Comentarios

Las funciones de configuración del espacio de nombres no afectan a las aplicaciones que ya se están ejecutando. Los proveedores de espacio de nombres recién instalados no serán visibles para las aplicaciones ni los cambios en el estado de activación de un proveedor de espacio de nombres. Las aplicaciones iniciadas después de la llamada a WSCUnInstallNameSpace verán los cambios.

Si se ejecuta correctamente, WSCUnInstallNameSpace intentará alertar a todas las aplicaciones interesadas que se hayan registrado para recibir notificaciones del cambio mediante una llamada a WSAProviderConfigChange.

Un usuario que inició sesión como miembro del grupo Administradores solo puede llamar a la función WSCUnInstallNameSpace . Si un usuario llama a WSCUnInstallNameSpace que no es miembro del grupo Administradores, se producirá un error en la llamada de función y se devolverá WSANO_RECOVERY en el parámetro lpErrno .

En el caso de los equipos que se ejecutan en Windows Vista o Windows Server 2008, esta función también puede producir un error debido al control de cuentas de usuario (UAC). Si un usuario que ha iniciado sesión como miembro del grupo Administradores que no sea el administrador integrado ejecuta esta función, se producirá un error en esta llamada a menos que la aplicación se haya marcado en el archivo de manifiesto con un valor requestedExecutionLevel establecido en requireAdministrator. Si la aplicación en Windows Vista o Windows Server 2008 carece de este archivo de manifiesto, un usuario que inició sesión como miembro del grupo Administradores distinto del administrador integrado debe ejecutar la aplicación en un shell mejorado como administrador integrado (administrador de runas) para que esta función se realice correctamente.

El autor de la llamada de esta función debe quitar los archivos adicionales o la información de configuración específica del proveedor de servicios necesaria para desinstalar completamente el proveedor de servicios.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado ws2spi.h
Library Ws2_32.lib
Archivo DLL Ws2_32.dll

Consulte también

WSAProviderConfigChange

WSCDeinstallProvider

WSCEnumProtocols

WSCInstallNameSpace

WSCUnInstallNameSpace32