LPNSPV2LOOKUPSERVICENEXTEX 콜백 함수(ws2spi.h)
통사론
LPNSPV2LOOKUPSERVICENEXTEX Lpnspv2lookupservicenextex;
void Lpnspv2lookupservicenextex(
[in] HANDLE hAsyncCall,
[in] HANDLE hLookup,
[in] DWORD dwControlFlags,
[in, out] LPDWORD lpdwBufferLength,
[out] LPWSAQUERYSET2W lpqsResults
)
{...}
매개 변수
[in] hAsyncCall
비동기 호출에 사용되는 NSPv2LookupServiceBegin 대한 이전 호출에서 반환된 핸들입니다.
[in] hLookup
NSPv2LookupServiceBegin
[in] dwControlFlags
다음 작업을 제어하는 데 사용되는 플래그입니다. 현재 LUP_FLUSHPREVIOUS 너무 큰 결과 집합을 처리하는 수단으로 정의됩니다. 애플리케이션이 충분히 큰 버퍼를 제공할 수 없는 경우 LUP_FLUSHPREVIOUS 설정하면 공급자가 너무 큰 마지막 결과 집합을 삭제하고 이 호출에 대한 다음 집합으로 이동하도록 지시합니다.
[in, out] lpdwBufferLength
lpqsResults가리키는 버퍼에 포함된 입력의 크기(바이트)입니다. 출력에서 함수가 실패하고 오류가 WSAEFAULT이면 레코드를 검색할 lpqsResults 전달할 최소 크기(바이트)가 포함됩니다.
[out] lpqsResults
반환 시 WSAQUERYSET2 구조에 하나의 결과 집합을 포함할 메모리 블록에 대한 포인터입니다.
반환 값
함수는 루틴이 성공하면 NO_ERROR(0)를 반환해야 합니다. 루틴이 실패하면 SOCKET_ERROR(즉, 1)을 반환해야 하며 WSASetLastError사용하여 적절한 오류 코드를 설정해야 합니다.
| 오류 코드 | 의미 |
|---|---|
|
이 호출이 계속 처리되는 동안 NSPv2LookupServiceEnd 호출이 수행되었습니다. 통화가 취소되었습니다.
lpqsResults 버퍼의 데이터는 정의되지 않습니다.
Windows 소켓 2에서 충돌하는 오류 코드는 |
|
|
더 이상 사용할 수 있는 데이터가 없습니다.
Windows 소켓 2에서 충돌하는 오류 코드는 |
|
|
lpqsResults 버퍼가 너무 작아서 WSAQUERYSET 집합을 포함할 수 없습니다. |
|
이 공급자에 대해 하나 이상의 매개 변수가 잘못되었거나 누락되었습니다. |
| 지정한 조회 핸들이 잘못되었습니다. | |
| 데이터베이스에서 이름이 발견되었지만 지정된 제한 사항과 일치하는 데이터가 없습니다. | |
| 서비스를 알 수 없습니다. 지정된 네임스페이스에서 서비스를 찾을 수 없습니다. | |
| 이 작업을 수행하는 데 사용할 수 있는 메모리가 부족합니다. |
발언
NSPv2LookupServiceNextEx 함수는 Windows Vista 이상에서 사용할 수 있는 NSPv2(네임스페이스 서비스 공급자 버전 2) 아키텍처의 일부로 사용됩니다.
Windows Vista 및 Windows Server 2008에서 NSPv2LookupServiceNextEx 함수는 NS_EMAIL 네임스페이스 공급자에 대한 작업에만 사용할 수 있습니다.
공급자는 lpqsResults 버퍼에 WSAQUERYSET2 구조를 전달합니다. 클라이언트는 모든 WSAQUERYSET2 구조가 반환되었음을 나타내는 WSA_E_NOMORE반환될 때까지 NSPv2LookupServiceNextEx 함수를 호출해야 합니다.
이 함수에 지정된
dwControlFlagsLUP_FLUSHPREVIOUS 및 LUP_RES_SERVICE 결합된 제한 규칙의 예외입니다("제한" 플래그 대신 동작 플래그이기 때문). NSPv2LookupServiceNextEx
예를 들어 NSPv2LookupServiceBeginLUP_RETURN_VERSION 지정된 경우 서비스 공급자는 버전을 포함한 레코드를 검색합니다. NSPv2LookupServiceNextExLUP_RETURN_VERSION 지정하지 않은 경우 반환된 정보에는 버전을 사용할 수 있었음에도 불구하고 해당 버전이 포함되지 않습니다. 오류가 생성되지 않습니다.
또한 예를 들어 LUP_RETURN_BLOBNSPv2LookupServiceBegin지정되지 않았지만 NSPv2LookupServiceNextEx지정된 경우 반환된 정보에는 개인 데이터가 포함되지 않습니다. 오류가 생성되지 않습니다.
NSPv2LookupServiceNextEx 함수는 일반적으로 두 번 이상 호출됩니다. lpqsResults 매개 변수가 가리키는 WSAQUERYSET2 수신하는 데 필요한 버퍼의 크기를 처음 가져오는 경우와 실제 쿼리 결과 집합을 가져오는 두 번째 시간입니다. 첫 번째 호출에서 NSPv2 공급자는 WSAQUERYSET2 결과에 필요한 크기를 반환해야 합니다.
반환되는 lpqsResults 매개 변수가 가리키는 WSAQUERYSET2 구조체는 WSAQUERYSET2 구조의 여러 멤버에 반환된 실제 데이터에 대한 포인터가 포함되어 있으므로 동일한 프로세스 컨텍스트에서만 유용합니다. 쿼리 결과를 다른 프로세스에 전달해야 하는 경우(예: RPC 사용) WSAQUERYSET2 구조의 멤버가 가리키는 데이터를 포함하여 lpqsResults 매개 변수가 가리키는 WSAQUERYSET2 구조에서 반환된 데이터를 직렬화하고 마샬링해야 합니다. 데이터는 프로세스 경계를 넘어 전달할 수 있는 형식으로 serialize되어야 합니다. 데이터에 대한 포인터만 전달되고 실제 데이터를 다른 프로세스에서 사용할 수 없으므로 WSAQUERYSET2 구조의 복사본을 전달하는 것만으로는 충분하지 않습니다.
쿼리 결과
다음 표에서는 WSAQUERYSET2 나열하고 **WSAQUERYSET2** 구조에서 쿼리 결과가 표시되는 방법을 설명합니다. 자세한 내용은 데이터 구조| WSAQUERYSET2 멤버 이름 | 결과 해석 |
|---|---|
| **dwSize** | WSAQUERYSET2 구조체의 크기(바이트)입니다. 이는 버전 관리 메커니즘으로 사용됩니다. |
| **lpszServiceInstanceName** | 서비스 이름을 포함하는 문자열입니다. |
| **lpVersion** | 특정 서비스 인스턴스의 버전 번호를 참조합니다. |
| **lpszComment** | 서비스 인스턴스에서 제공하는 주석 문자열입니다. 이 멤버는 NSPv2 서비스 공급자의 요구 사항에 따라 선택 사항입니다. |
| **dwNameSpace** | 이름 또는 서비스 인스턴스가 발견된 네임스페이스 식별자입니다. |
| **lpNSProviderId** | 이 쿼리 결과를 제공한 특정 네임스페이스 공급자입니다. |
| **lpszContext** | 서비스가 있는 계층 구조 네임스페이스의 컨텍스트 지점입니다. |
| **dwNumberOfProtocols** | 이 멤버는 결과에 대해 정의되지 않았습니다. |
| **lpafpProtocols** | 이 멤버는 결과에 대해 정의되지 않았습니다. 필요한 모든 프로토콜 정보는 CSADDR_INFO 구조에 있습니다. |
| **lpszQueryString** | dwControlFlags **LUP_RETURN_QUERY_STRING**를 포함하면 이 멤버는 원래 쿼리에 지정된 **lpszServiceInstanceName**의 분할되지 않은 나머지를 반환합니다. 예를 들어 호스트 이름 및 해당 호스트 내의 파일 경로를 지정하는 계층적 이름으로 서비스를 식별하는 네임스페이스에서 반환되는 주소는 호스트 주소일 수 있고 나머지는 파일 경로일 수 있습니다. **lpszServiceInstanceName**이 완전히 구문 분석되고 **LUP_RETURN_QUERY_STRING**를 사용하는 경우 이 멤버는 null이거나 길이가 0인 문자열을 가리킵니다. |
| **dwNumberOfCsAddrs** | CSADDR_INFO 구조체 배열의 요소 수입니다. |
| **lpcsaBuffer** | 각 요소 내에 하나의 전체 전송 주소가 포함된 CSADDR_INFO 구조의 배열에 대한 포인터입니다. |
| **dwOutputFlags** | **RESULT_IS_ALIAS** 플래그는 별칭 결과임을 나타냅니다. |
| **lpBlob** | 공급자별 엔터티에 대한 포인터입니다. 이 멤버는 NSPv2 서비스 공급자의 요구 사항에 따라 선택 사항입니다. |
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | ws2spi.h |
참고 항목
NSPv2Cleanup
NSPv2LookupServiceEnd
NSPv2SetServiceEx
NSPv2Startup