accept 函式 (winsock2.h)

  • 發行項

accept 函式允許套接字上的連入連線嘗試。

語法

SOCKET WSAAPI accept(
  [in]      SOCKET   s,
  [out]     sockaddr *addr,
  [in, out] int      *addrlen
);

參數

[in] s

描述項，識別已使用 接聽 函式處於接聽狀態的套接字。 連接實際上是由 accept 傳回的套接字所建立。

[out] addr

接收連線實體位址的緩衝區選擇性指標，稱為通訊層。 addr 參數的確切格式是由從sockaddr結構建立套接字時所建立的位址系列所決定。

[in, out] addrlen

包含 addr 參數所指向之結構長度的整數選擇性指標。

傳回值

如果沒有發生錯誤， accept 會傳回 SOCKET 類型的值，這個值是新 套接字 的描述項。 這個傳回的值是建立實際連接之套接字的句柄。

否則，會傳回 INVALID_SOCKET 的值，並呼叫 WSAGetLastError 來擷取特定的錯誤碼。

addrlen 所參考的整數一開始包含 addr 所指向的空間量。傳回時，它會包含所傳回位址的實際長度，以位元組為單位。

錯誤碼 意義
WSANOTINITIALISED
 使用這個函式之前，必須先進行成功的 WSAStartup 呼叫。
WSAECONNRESET
 表示連入連線，但後續由遠端對等終止，再接受呼叫。
WSAEFAULT
 addrlen 參數太小，或 addr 不是使用者地址空間的有效部分。
WSAEINTR
 封鎖的 Windows Sockets 1.1 呼叫已透過 WSACancelBlockingCall 取消。
WSAEINVAL
 接 聽 函式在 接受之前未叫用。
WSAEINPROGRESS
 封鎖的 Windows Sockets 1.1 呼叫正在進行中，或服務提供者仍在處理回呼函式。
WSAEMFILE
 佇列在 要接受 的專案時是空的，而且沒有描述項可供使用。
WSAENETDOWN
 網路子系統失敗。
WSAENOBUFS
 沒有可用的緩衝區空間。
WSAENOTSOCK
 描述項不是套接字。
WSAEOPNOTSUPP
 參考的套接字不是支援連接導向服務的型別。
WSAEWOULDBLOCK
 套接字會標示為非封鎖，而且沒有任何連線可供接受。

備註

accept 函式會擷取套接字上擱置連線佇列上的第一個連線。 然後，它會建立並傳回新套接字的句柄。 新建立的套接字是將處理實際連線的套接字;它具有 與套接字相同的屬性，包括向 WSAAsyncSelect 或 WSAEventSelect 函式註冊的異步事件。

如果佇列上沒有暫止連線，且套接字標示為封鎖， 接受 函式可以封鎖呼叫端，直到連接存在為止。 如果套接字標示為非封鎖，且佇列上沒有擱置的連線， accept 會傳回錯誤，如下列所述。 成功完成 接受 會傳回新的套接字句柄之後，無法使用接受的套接字來接受更多連線。 原始套接字會保持開啟狀態，並接聽新的連線要求。

參數 載入器 是填入連線實體位址的結果參數，稱為通訊層。 addr 參數的確切格式是由通訊發生的位址系列所決定。 addrlen 是 value-result 參數;它一開始應該包含 addr 所指向的空間量;傳回時，它會包含所傳回位址) 以位元組為單位的實際長度 (。

accept 函式會與連線導向的套接字類型搭配使用，例如 SOCK_STREAM。 如果 addr 和/或 addrlen 等於 NULL，則不會傳回所接受套接字遠端地址的相關信息。

注意發出封鎖的 Winsock 呼叫時，例如 accept，Winsock 可能需要等候網路事件，才能完成呼叫。 在此情況下，Winsock 會執行可警示的等候，而異步過程調用 (APC) 排程在相同線程上可能會中斷。 在 APC 內發出另一個封鎖 Winsock 呼叫，中斷相同線程上持續封鎖 Winsock 呼叫會導致未定義的行為，而且永遠不會由 Winsock 客戶端嘗試。
 

範例程序代碼

下列範例示範 使用 accept 函式。 
#ifndef UNICODE
#define UNICODE
#endif

#include <winsock2.h>
#include <WS2tcpip.h>
#include <stdio.h>
#include <windows.h>

// Need to link with Ws2_32.lib
#pragma comment(lib, "Ws2_32.lib")

int wmain(void)
{

    //----------------------
    // Initialize Winsock.
    WSADATA wsaData;
    int iResult = WSAStartup(MAKEWORD(2, 2), &wsaData);
    if (iResult != NO_ERROR) {
        wprintf(L"WSAStartup failed with error: %ld\n", iResult);
        return 1;
    }
    //----------------------
    // Create a SOCKET for listening for
    // incoming connection requests.
    SOCKET ListenSocket;
    ListenSocket = socket(AF_INET, SOCK_STREAM, IPPROTO_TCP);
    if (ListenSocket == INVALID_SOCKET) {
        wprintf(L"socket failed with error: %ld\n", WSAGetLastError());
        WSACleanup();
        return 1;
    }
    //----------------------
    // The sockaddr_in structure specifies the address family,
    // IP address, and port for the socket that is being bound.
    sockaddr_in service;
    service.sin_family = AF_INET;
    service.sin_port = htons(27015);
    inet_pton(AF_INET, "127.0.0.1", &service.sin_addr);

    if (bind(ListenSocket,
             (SOCKADDR *) & service, sizeof (service)) == SOCKET_ERROR) {
        wprintf(L"bind failed with error: %ld\n", WSAGetLastError());
        closesocket(ListenSocket);
        WSACleanup();
        return 1;
    }
    //----------------------
    // Listen for incoming connection requests.
    // on the created socket
    if (listen(ListenSocket, 1) == SOCKET_ERROR) {
        wprintf(L"listen failed with error: %ld\n", WSAGetLastError());
        closesocket(ListenSocket);
        WSACleanup();
        return 1;
    }
    //----------------------
    // Create a SOCKET for accepting incoming requests.
    SOCKET AcceptSocket;
    wprintf(L"Waiting for client to connect...\n");

    //----------------------
    // Accept the connection.
    AcceptSocket = accept(ListenSocket, NULL, NULL);
    if (AcceptSocket == INVALID_SOCKET) {
        wprintf(L"accept failed with error: %ld\n", WSAGetLastError());
        closesocket(ListenSocket);
        WSACleanup();
        return 1;
    } else
        wprintf(L"Client connected.\n");

    // No longer need server socket
    closesocket(ListenSocket);

    WSACleanup();
    return 0;
}

如需使用 accept 函式的另一個範例，請參閱 使用者入門 With Winsock。

ATM 的注意事項

以下是與連線設定相關聯的重要問題，而且在使用異步傳輸模式 (ATM) 搭配 Windows Sockets 2 時必須考慮：

  • accept 和 WSAAccept 函式不一定設定遠端位址和地址長度參數。 因此，使用 ATM 時，呼叫端應該使用 WSAAccept 函式，並將ATM_CALLING_PARTY_NUMBER_IE放在 QoS 結構的 ProviderSpecific 成員中，其本身會包含在根據 WSAAccept 使用的回呼函式的 lpSQOS 參數中。
  • 使用 accept 函式時，請注意，在連線建立之前，函式可能會傳回給傳送者和接收者之間的整個距離。 這是因為在接收 CONNECT ACK 訊息時 ，accept 函式會立即傳回;在 ATM 中，CONNECT ACK 訊息會在路徑中的下一個參數在處理 (時傳回，而不是最終建立連線的結束節點所傳送的 CONNECT ACK) 。 因此，應用程式應該瞭解，如果在收到 CONNECT ACK 訊息之後立即傳送數據，可能會遺失數據，因為傳送者和接收者之間可能尚未建立連線。

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

另請參閱

WSAAccept

WSAAsyncSelect

Winsock 函式

Winsock 參考

bind

connect

listen

select

sockaddr

socket