WSAAccept 함수(winsock2.h)
WSAAccept 함수는 조건부로 조건부 함수의 반환 값에 따라 연결을 허용하고, 서비스 흐름 사양의 품질을 제공하며, 연결 데이터 전송을 허용합니다.
통사론
SOCKET WSAAPI WSAAccept(
[in] SOCKET s,
[out] sockaddr *addr,
[in, out] LPINT addrlen,
[in] LPCONDITIONPROC lpfnCondition,
[in] DWORD_PTR dwCallbackData
);
매개 변수
[in] s
listen 함수를 호출한 후 연결을 수신 대기하는 소켓을 식별하는 설명자입니다.
[out] addr
통신 계층에 알려진 연결 엔터티의 주소를 수신하는 sockaddr 구조체에 대한 선택적 포인터입니다. addr 매개 변수의 정확한 형식은 소켓을 만들 때 설정된 주소 패밀리에 의해 결정됩니다.
[in, out] addrlen
addr 매개 변수가 가리키는 sockaddr 구조체의 길이를 바이트 단위로 포함하는 정수에 대한 선택적 포인터입니다.
[in] lpfnCondition
매개 변수로 전달된 호출자 정보에 따라 수락/거부 결정을 내리고, 필요에 따라 이 함수의
[in] dwCallbackData
콜백 데이터는 조건 함수에 전달된 dwCallbackData 매개 변수의 값으로 애플리케이션에서 지정한 조건 함수로 다시 전달됩니다. 이 매개 변수는
반환 값
오류가 발생하지 않으면 WSAAccept 허용되는 소켓에 대한 설명자인 SOCKET 형식의 값을 반환합니다. 그렇지 않으면 INVALID_SOCKET 값이 반환되고 WSAGetLastError호출하여 특정 오류 코드를 검색할 수 있습니다.
addrlen 참조하는 정수에는 처음에는 추가기가리키는 공간의 양이 포함됩니다. 반환될 때 반환된 주소의 실제 길이(바이트)가 포함됩니다.
| 오류 코드 | 의미 |
|---|---|
|
액세스 권한에 의해 금지된 방식으로 소켓에 액세스하려고 했습니다. 제공된 연결 요청 시간이 초과되었거나 철회된 경우 이 오류가 반환됩니다. |
|
대상 컴퓨터가 적극적으로 거부했기 때문에 연결할 수 없습니다. 이 오류는 조건 함수(CF_REJECT)의 반환 값에 표시된 대로 연결 요청이 강제로 거부된 경우 반환됩니다. |
|
기존 연결이 원격 호스트에 의해 강제로 닫혔습니다. 이 오류는 들어오는 연결이 표시되었지만 호출을 수락하기 전에 원격 피어에 의해 종료된 경우 반환됩니다. |
|
시스템에서 호출에서 포인터 인수를 사용하려고 할 때 잘못된 포인터 주소를 검색했습니다. 이 오류는 addrlen 매개 변수가 너무 작거나 |
|
WSACancelBlockingCall |
|
차단 작업이 현재 실행되고 있습니다. 차단 Windows 소켓 1.1 호출이 진행 중인 경우 이 오류가 반환됩니다. |
|
잘못된 인수가 제공되었습니다. 이 오류는 WSAAccept전에 수신 대기 호출되지 않았거나, 조건 함수의 반환 값이 유효한 값이 아니거나, 지정된 소켓이 잘못된 상태인 경우 반환됩니다. |
|
열린 소켓이 너무 많습니다. 이 오류는 WSAAccept 입력 시 큐가 비어 있지 않고 사용할 수 있는 소켓 설명자가 없는 경우 반환됩니다. |
|
소켓 작업에 데드 네트워크가 발견되었습니다. 네트워크 하위 시스템이 실패한 경우 이 오류가 반환됩니다. |
| 시스템에 충분한 버퍼 공간이 부족하거나 큐가 꽉 찼기 때문에 소켓에 대한 작업을 수행할 수 없습니다. 버퍼 공간을 사용할 수 없는 경우 이 오류가 반환됩니다. | |
|
소켓이 아닌 항목에서 작업이 시도되었습니다. 이 오류는 매개 변수에 전달된 소켓 설명자가 소켓이 아닌 경우 반환됩니다. |
|
프로토콜 패밀리가 시스템에 구성되지 않았거나 구현이 없습니다. 참조된 소켓이 연결 지향 서비스를 지원하는 형식이 아닌 경우 이 오류가 반환됩니다. |
|
비차단 소켓 작업을 즉시 완료할 수 없습니다. 소켓이 차단 해제로 표시되고 수락할 연결이 없는 경우 이 오류가 반환됩니다. |
| 애플리케이션이 WSAStartup호출하지 않았거나 WSAStartup 실패했습니다. 이 오류는 이 함수를 사용하기 전에 WSAStartup 함수 dit에 대한 호출이 성공적으로 수행되면 반환됩니다. | |
| 이는 일반적으로 호스트 이름 확인 중에 일시적인 오류이며 로컬 서버가 신뢰할 수 있는 서버로부터 응답을 받지 못했음을 의미합니다. 이 오류는 조건 함수(CF_DEFER)의 반환 값에 표시된 대로 연결 요청 수락이 지연된 경우 반환됩니다. |
발언
애플리케이션이 WSAAccept
애플리케이션이
addr 매개 변수는 통신 계층에 알려진 연결 엔터티의 주소로 채워진 결과 매개 변수입니다. addr 매개 변수의 정확한 형식은 통신이 발생하는 주소 패밀리에 의해 결정됩니다. addrlen 값 결과 매개 변수입니다. 처음에는 추가기가리키는 공간의 양을 포함해야 합니다. 반환되는 경우 반환된 주소의 실제 길이(바이트)를 포함합니다. 이 호출은 SOCK_STREAM 같은 연결 지향 소켓 형식에 사용됩니다. addrr 및/또는 addrlenNULL같으면 허용된 소켓의 원격 주소에 대한 정보가 반환되지 않습니다. 그렇지 않으면 연결이 성공적으로 수락되면 이러한 두 매개 변수가 채워집니다.
조건 함수의 프로토타입은 다음과 같이 Winsock2.h 헤더 파일에 LPCONDITIONPROC정의됩니다.
int CALLBACK
ConditionFunc(
IN LPWSABUF lpCallerId,
IN LPWSABUF lpCallerData,
IN OUT LPQOS lpSQOS,
IN OUT LPQOS lpGQOS,
IN LPWSABUF lpCalleeId,
IN LPWSABUF lpCalleeData,
OUT GROUP FAR * g,
IN DWORD_PTR dwCallbackData
);
ConditionFunc 애플리케이션에서 지정한 콜백 함수의 자리 표시자입니다. 실제 조건 함수는 DLL 또는 애플리케이션 모듈에 있어야 합니다. 모듈 정의 파일에서 내보냅니다.
lpCallerId 매개 변수는 연결 엔터티의 주소를 포함하는 WSABUF 구조를 가리킵니다. 여기서 len 매개 변수는 버퍼의 길이(바이트)이고 buf 매개 변수는 버퍼에 대한 포인터입니다.
lpCallerData 모든 사용자 데이터를 포함하는 값 매개 변수입니다. 이러한 매개 변수의 정보는 연결 요청과 함께 전송됩니다. 호출자 ID 또는 호출자 데이터를 사용할 수 없는 경우 해당 매개 변수는 NULL
lpSQOS 매개 변수는 호출자가 지정한 소켓 대한 FLOWSPEC 구조를 참조하고 각 방향에 대해 하나씩 추가 공급자별 매개 변수를 참조합니다. 송신 또는 수신 흐름 사양 값은 단방향 소켓에 대해 적절하게 무시됩니다. NULL 값은 호출자가 제공하는 서비스 품질이 없고 협상이 가능하지 않음을 나타냅니다. NULLlpSQOS 포인터는 서비스 품질 협상이 발생하거나 공급자가 협상 없이 서비스 품질 요청을 수락할 준비가 되었음을 나타냅니다.
lpCalleeId 연결된 엔터티의 로컬 주소를 포함하는 매개 변수입니다.
lpCalleeData 조건 함수에서 사용자 데이터를 연결 엔터티에 다시 제공하는 데 사용하는 결과 매개 변수입니다.
lpCalleeData->len 처음에는 서비스 공급자가 할당하고 lpCalleeData->buf가리키는 버퍼의 길이를 포함합니다. 값이 0이면 사용자 데이터를 호출자에게 다시 전달할 수 없습니다. 조건 함수는 최대 lpCalleeData->len 바이트의 데이터를 lpCalleeData->buf복사한 다음 lpCalleeData- >len 업데이트하여 전송된 실제 바이트 수를 나타냅니다. 호출자에게 다시 전달할 사용자 데이터가 없는 경우 조건 함수는 lpCalleeData-
g 매개 변수는 다음 작업 중 어느 것을 나타내기 위해 조건 함수 내에 할당됩니다.
- g 기존 소켓 그룹 식별자인 경우 이 그룹에서 설정한 모든 요구 사항이 충족되면 이 그룹에 추가합니다.
- g = SG_UNCONSTRAINED_GROUP 경우 제약이 없는 소켓 그룹을 만들고 첫 번째 멤버로 만듭니다.
- = SG_CONSTRAINED_GROUP
경우 제한된 소켓 그룹을 만들고 첫 번째 멤버로 만듭니다. - g = 0이면 그룹 작업이 수행되지 않습니다.
조건 함수에 전달된 dwCallbackData 매개 변수 값은 원래 WSAAccept 호출에서 dwCallbackData 매개 변수로 전달되는 값입니다. 이 값은 Windows 소켓 버전 2 클라이언트에서만 해석됩니다. 이렇게 하면 클라이언트가 WSAAccept 호출 사이트에서 조건 함수로 일부 컨텍스트 정보를 전달할 수 있습니다. 또한 연결 허용 여부를 결정하는 데 필요한 추가 정보를 조건 함수에 제공합니다. 일반적인 사용법은 이 소켓이 연결된 애플리케이션 정의 개체에 대한 참조를 포함하는 데이터 구조에 적절한 캐스트 포인터를 전달하는 것입니다.
예제 코드
다음 예제에서는 WSAAccept 함수를 사용하는 방법을 보여 줍니다.#include <winsock2.h>
#include <stdio.h>
#include <windows.h>
/* Define an example conditional function that depends on the pQos field */
int CALLBACK ConditionAcceptFunc(
LPWSABUF lpCallerId,
LPWSABUF lpCallerData,
LPQOS pQos,
LPQOS lpGQOS,
LPWSABUF lpCalleeId,
LPWSABUF lpCalleeData,
GROUP FAR * g,
DWORD_PTR dwCallbackData
)
{
if (pQos != NULL) {
RtlZeroMemory(pQos, sizeof(QOS));
return CF_ACCEPT;
} else
return CF_REJECT;
}
int main() {
/* Declare and initialize variables */
WSADATA wsaData;
SOCKET ListenSocket, AcceptSocket;
struct sockaddr_in saClient;
int iClientSize = sizeof(saClient);
u_short port = 27015;
char* ip;
sockaddr_in service;
int error;
/* Initialize Winsock */
error = WSAStartup(MAKEWORD(2,2), &wsaData);
if (error) {
printf("WSAStartup() failed with error: %d\n", error);
return 1;
}
/* Create a TCP listening socket */
ListenSocket = socket(AF_INET, SOCK_STREAM, IPPROTO_TCP);
if (ListenSocket == INVALID_SOCKET) {
printf("socket() failed with error: %d\n", WSAGetLastError() );
WSACleanup();
return 1;
}
/*-----------------------------------------
* Set up the sock addr structure that the listening socket
* will be bound to. In this case, the structure holds the
* local IP address and the port specified. */
service.sin_family = AF_INET;
service.sin_port = htons(port);
hostent* thisHost;
thisHost = gethostbyname("");
ip = inet_ntoa (*(struct in_addr *)*thisHost->h_addr_list);
service.sin_addr.s_addr = inet_addr(ip);
/*-----------------------------------------
* Bind the listening socket to the IP address.
* and port number specified by the sockaddr structure. */
error = bind(ListenSocket, (SOCKADDR *) &service, sizeof(SOCKADDR));
if (error == SOCKET_ERROR) {
printf("bind() failed with error: %d\n", WSAGetLastError() );
closesocket(ListenSocket);
WSACleanup();
return 1;
}
/* Make the socket listen for incoming connection requests */
error = listen(ListenSocket, 1);
if (error == SOCKET_ERROR) {
printf("listen() failed with error: %d\n", WSAGetLastError() );
closesocket(ListenSocket);
WSACleanup();
return 1;
}
printf("Listening...\n");
/*-----------------------------------------
* Accept an incoming connection request on the
* listening socket and transfer control to the
* accepting socket. */
AcceptSocket = WSAAccept(ListenSocket, (SOCKADDR*) &saClient, &iClientSize,
&ConditionAcceptFunc, NULL);
/* Now do some work with the AcceptSocket
* At this point, the application could
* handle data transfer on the socket, or other socket
* functionality.*/
/* Then clean up and quit */
closesocket(AcceptSocket);
closesocket(ListenSocket);
WSACleanup();
return 0;
}
Windows Phone 8: 이 함수는 Windows Phone 8 이상에서 Windows Phone 스토어 앱에 대해 지원됩니다.
Windows 8.1 및 Windows Server 2012 R2: 이 함수는 Windows 8.1, Windows Server 2012 R2 이상의 Windows 스토어 앱에서 지원됩니다.
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 8.1, Windows Vista [데스크톱 앱 | UWP 앱] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱 | UWP 앱] |
| 대상 플랫폼 | Windows |
| 헤더 | winsock2.h |
| 라이브러리 | Ws2_32.lib |
| DLL | Ws2_32.dll |
참고 항목
WSAAsyncSelect
WSAConnect
WSASocket
수락
바인딩