LPNSPV2LOOKUPSERVICEEND 콜백 함수(ws2spi.h)

아티클
08/28/2023

NSPv2LookupServiceEnd 함수는 NSPv2LookupServiceBegin 및 NSPv2LookupServiceNextEx에 대한 이전 호출 후 핸들을 해제하기 위해 호출됩니다.

구문

LPNSPV2LOOKUPSERVICEEND Lpnspv2lookupserviceend;

INT Lpnspv2lookupserviceend(
  [in] HANDLE hLookup
)
{...}

매개 변수

[in] hLookup

에 대한 호출에서 이전에 가져온 핸들입니다.
NSPv2LookupServiceBegin.

반환 값

함수는 루틴이 성공하면 NO_ERROR (0)를 반환해야 합니다. 루틴이 실패하고 WSASetLastError를 사용하여 적절한 오류 코드를 설정해야 하는 경우 SOCKET_ERROR(즉, 1)를 반환해야 합니다.

오류 코드	의미
WSA_INVALID_HANDLE	핸들이 잘못되었습니다.
WSA_NOT_ENOUGH_MEMORY	이 작업을 수행하는 데 사용할 수 있는 메모리가 부족합니다.

설명

NSPv2LookupServiceEnd 함수는 Windows Vista 이상에서 사용할 수 있는 네임스페이스 서비스 공급자 버전 2(NSPv2) 아키텍처의 일부로 사용됩니다.

Windows Vista 및 Windows Server 2008에서 NSPv2LookupServiceEnd 함수는 NS_EMAIL 네임스페이스 공급자의 작업에만 사용할 수 있습니다.

NSPv2LookupServiceNextEx를 처리하는 동안 다른 스레드에서 NSPv2LookupServiceBegin 함수 호출을 받을 수 있습니다. 이는 클라이언트가 요청을 취소했으며 공급자가 NSPv2LookupServiceNextEx 함수 호출에서도 핸들을 닫고 반환해야 하며 마지막 오류를 WSA_E_CANCELLED 설정합니다.

Windows 소켓 2에서는 WSAECANCELLED 및 WSA_E_CANCELLED 대해 충돌하는 오류 코드가 정의됩니다. 오류 코드 WSAECANCELLED 는 이후 버전에서 제거되며 WSA_E_CANCELLED 유지됩니다. 네임스페이스 공급자는 가능한 가장 광범위한 애플리케이션과의 호환성을 유지하기 위해 WSA_E_CANCELLED 오류 코드를 사용해야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	ws2spi.h