LPNSPCLEANUP 回呼函式 (ws2spi.h)

NSPCleanup 函式會終止使用特定的 Windows Sockets 命名空間服務提供者。

語法

LPNSPCLEANUP Lpnspcleanup;

INT Lpnspcleanup(
  [in] LPGUID lpProviderId
)
{...}

參數

[in] lpProviderId

要終止之命名空間提供者 之 GUID 的指標。

傳回值

如果沒有發生錯誤， NSPCleanup 會傳回NO_ERROR ( 零) 的值。 否則會傳回 SOCKET_ERROR (–1) ，而且提供者必須使用 WSASetLastError 設定適當的錯誤碼。

錯誤碼	意義
WSA_NOT_ENOUGH_MEMORY	記憶體不足，無法執行這項作業。
WSAEINVAL	lpProviderId 參數未指定有效的提供者。
WSAEOPNOTSUPP	不支援此作業。 如果命名空間提供者未實作此函式，就會傳回此錯誤。

備註

當應用程式使用 Windows Sockets 命名空間服務提供者完成時，會呼叫 NSPCleanup 函式。 NSPCleanup 函式會取消註冊特定命名空間提供者，並允許傳輸服務提供者釋放任何命名空間提供者配置的資源。

使用任何命名空間提供者之前，必須先成功呼叫 NSPStartup 函式。 允許進行一個以上的 NSPStartup 呼叫。 不過，針對每個 NSPStartup 呼叫，也必須發出對應的 NSPCleanup 呼叫。 只有服務提供者的最終 NSPCleanup 才會進行實際的清除;上述呼叫會遞減服務提供者中的內部參考計數。

在命名空間服務提供者 DLL 可以從記憶體卸除之前，不應該傳回此函式。

規格需求

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	ws2spi.h

另請參閱

• NSPStartup
• WSASetLastError