WSADeleteSocketPeerTargetName 함수(ws2tcpip.h)

아티클
03/04/2024

WSADeleteSocketPeerTargetName 함수는 피어 대상 이름과 소켓의 IP 주소 간의 연결을 제거합니다. 반환이 성공하면 IP 주소와 대상 이름 간에 나중에 연결되지 않습니다.

구문

INT WSAAPI WSADeleteSocketPeerTargetName(
  [in]           SOCKET                             Socket,
  [in]           const sockaddr                     *PeerAddr,
  [in]           ULONG                              PeerAddrLen,
  [in, optional] LPWSAOVERLAPPED                    Overlapped,
  [in, optional] LPWSAOVERLAPPED_COMPLETION_ROUTINE CompletionRoutine
);

매개 변수

[in] Socket

피어 대상 이름이 삭제되는 소켓을 식별하는 설명자입니다.

[in] PeerAddr

대상 이름이 삭제되는 피어의 IP 주소입니다.

[in] PeerAddrLen

PeerAddr 매개 변수의 크기(바이트)입니다.

[in, optional] Overlapped

WSAOVERLAPPED 구조체에 대한 포인터입니다. 이 매개 변수는 겹치지 않는 소켓에 대해 무시됩니다.

[in, optional] CompletionRoutine

작업이 완료될 때 호출되는 완료 루틴에 대한 포인터입니다. 이 매개 변수는 겹치지 않는 소켓에 대해 무시됩니다.

반환 값

함수가 성공하면 반환 값은 0입니다. 그렇지 않으면 SOCKET_ERROR 값이 반환되고 WSAGetLastError를 호출하여 특정 오류 코드를 검색할 수 있습니다.

몇 가지 가능한 오류 코드가 아래에 나열되어 있습니다.

오류 코드	의미
WSAEAFNOSUPPORT	지정된 주소 패밀리는 지원되지 않습니다.
WSAEFAULT	시스템에서 호출의 포인터 인수를 사용하려고 할 때 잘못된 주소 포인터를 감지했습니다. PeerAddr 매개 변수가 NULL 포인터인 경우 이 오류가 반환됩니다.
WSAEINVAL	잘못된 매개 변수가 전달되었습니다. Socket 매개 변수에 전달된 소켓이 AF_INET 또는 AF_INET6 주소 패밀리와 SOCK_DGRAM 또는SOCK_STREAM 소켓 형식으로 만들어지지 않은 경우 이 오류가 반환됩니다.
WSAEMSGSIZE	전달된 버퍼가 너무 작습니다.
WSAENOTSOCK	Socket 매개 변수에 전달된 설명자가 유효한 소켓이 아닙니다.

설명

WSADeleteSocketPeerTargetName 함수는 피어 대상 이름과 소켓의 IP 주소 간의 연결을 제거하는 메서드를 제공합니다. 이 함수는 이전에 WSASetSocketPeerTargetName 함수로 설정된 피어 대상 이름을 삭제하는 데 사용됩니다. WSADeleteSocketPeerTargetName 함수가 반환된 후에는 IP 주소에 대한 향후 인증에서 이전에 지정된 대상 이름을 사용하지 않습니다. 이 함수는 피어 대상 이름과 연결된 IP 주소와의 연결을 종료한 후 연결이 없는 클라이언트(예: 형식이 SOCK_DGRAM 설정되거나 프로토콜이 IPPROTO_UDP 설정된 소켓)에서 주로 사용하도록 설계되었습니다. 연결 지향 클라이언트(예: 형식이 SOCK_STREAM 설정되거나 프로토콜이 IPPROTO_TCP 설정된 소켓)의 경우 이 함수를 호출해서는 안 됩니다.

WSADeleteSocketPeerTargetName 함수를 사용하면 dwIoControlCode 매개 변수가 SIO_DELETE_PEER_TARGET_NAME 설정된 WSAIoctl 함수를 호출할 필요가 간소화됩니다.

다음 조건이 충족되지 않으면 오류가 반환됩니다.

Socket 매개 변수의 주소 패밀리는 AF_INET 또는 AF_INET6 합니다.
소켓 유형은 SOCK_STREAM 또는 SOCK_DGRAM.

요구 사항

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