LPNSPCLEANUP 콜백 함수(ws2spi.h)
NSPCleanup 함수는 특정 Windows 소켓 네임스페이스 서비스 공급자의 사용을 종료합니다.
구문
LPNSPCLEANUP Lpnspcleanup;
INT Lpnspcleanup(
[in] LPGUID lpProviderId
)
{...}
매개 변수
[in] lpProviderId
종료할 네임스페이스 공급자의 GUID 에 대한 포인터입니다.
반환 값
오류가 발생하지 않으면 NSPCleanup 은 NO_ERROR 값(0)을 반환합니다. 그렇지 않으면 SOCKET_ERROR (–1)가 반환되고 공급자는 WSASetLastError를 사용하여 적절한 오류 코드를 설정해야 합니다.
오류 코드 | 의미 |
---|---|
WSA_NOT_ENOUGH_MEMORY | 이 작업을 수행하는 데 사용할 수 있는 메모리가 부족합니다. |
WSAEINVAL | lpProviderId 매개 변수는 유효한 공급자를 지정하지 않습니다. |
WSAEOPNOTSUPP | 이 작업은 지원되지 않습니다. 네임스페이스 공급자가 이 함수를 구현하지 않으면 이 오류가 반환됩니다. |
설명
NSPCleanup 함수는 애플리케이션이 Windows 소켓 네임스페이스 서비스 공급자를 사용하여 완료되면 호출됩니다. NSPCleanup 함수는 특정 네임스페이스 공급자를 등록 취소하고 전송 서비스 공급자가 네임스페이스 공급자의 할당된 리소스를 해제할 수 있도록 합니다.
네임스페이스 공급자를 사용하기 전에 NSPStartup 함수를 성공적으로 호출해야 합니다. 두 개 이상의 NSPStartup 호출을 할 수 있습니다. 그러나 각 NSPStartup 호출에 대해 해당 NSPCleanup 호출도 실행해야 합니다. 서비스 공급자에 대한 최종 NSPCleanup 만 실제 정리를 수행합니다. 앞의 호출은 서비스 공급자의 내부 참조 수를 감소합니다.
이 함수는 메모리에서 네임스페이스 서비스 공급자 DLL을 언로드할 수 있을 때까지 를 반환해서는 안 됩니다.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
대상 플랫폼 | Windows |
헤더 | ws2spi.h |