Platform SDK: Windows Sockets

WSCDeinstallProvider

The WSCDeinstallProvider function removes the specified transport provider from the system configuration database.

int WSCDeinstallProvider (
  LPGUID   lpProviderId,   
  LPINT    lpErrno          
);

Parameters

lpProviderId
[in] Globally unique identifier of the provider to deinstall. This value is stored within each WSAPROTOCOL_INFOW structure.
lpErrno
[out] Pointer to the error code.

Return Values

If no error occurs, WSCDeinstallProvider returns zero. Otherwise, it returns SOCKET_ERROR, and a specific error code is available in lpErrno.

Remarks

The WSCDeinstallProvider function removes the common Windows Sockets 2 configuration information for the specified provider. After this routine completes successfully, the configuration information stored in the registry will be changed. However, any Ws2_32.dll instances currently in memory will not be able to see this change.

The caller of this function must remove any additional files or service provider–specific configuration information that is needed to completely de-install the service provider.

Error Codes

Error code Meaning
WSAEINVAL The lpProviderId does not specify a valid provider.
WSAEFAULT The lpErrno is not in a valid part of the user address space.

Requirements

  Version: Requires Windows Sockets 2.0.
  Header: Declared in Ws2spi.h.
  Library: Use Ws2_32.lib.

See Also

WSCInstallProvider, WSCEnumProtocols