CreateSortedAddressPairs 함수

제공된 잠재적 IP 대상 주소 목록에서 CreateSortedAddressPairs 함수는 대상 주소를 호스트 컴퓨터의 로컬 IP 주소와 쌍으로 연결하고 기본 통신 순서에 따라 쌍을 정렬합니다.

구문

NETIOAPI_API CreateSortedAddressPairs(
  _In_opt_ const PSOCKADDR_IN6      SourceAddressList,
  _In_           ULONG              SourceAddressCount,
  _In_     const PSOCKADDR_IN6      DestinationAddressList,
  _In_           ULONG              DestinationAddressCount,
  _In_           ULONG              AddressSortOptions,
  _In_           PSOCKADDR_IN6_PAIR *SortedAddressPairList,
  _Out_          ULONG              *SortedAddressPairCount
);

매개 변수

• SourceAddressList [in, optional]
  예약되어 있습니다. 이 매개 변수는 NULL이어야 합니다.

• SourceAddressCount [in]
  예약되어 있습니다. 이 매개 변수는 0이어야 합니다.

• DestinationAddressList [in]
  SOCKADDR_IN6 형식의 잠재적 대상 주소 목록에 대한 포인터입니다.

• DestinationAddressCount [in]
  DestinationAddressList 매개 변수가 가리키는 목록의 주소 수입니다.

• AddressSortOptions [in]
  예약되어 있습니다. 이 매개 변수는 0이어야 합니다.

• SortedAddressPairList [in]
  기본 통신 순서로 정렬된 원본 및 대상 주소 쌍의 목록에 대한 포인터입니다. 이 매개 변수에 대한 자세한 내용은 다음 주의 섹션을 참조하세요.

• SortedAddressPairCount [out]
  SortedAddressPairList 매개 변수가 가리키는 목록의 주소 쌍 수입니다.

반환 값

CreateSortedAddressPairs는 함수가 성공하면 STATUS_SUCCESS 반환합니다.

함수가 실패하면 CreateSortedAddressPairs 는 다음 오류 코드 중 하나를 반환합니다.

설명

CreateSortedAddressPairs 함수는 호스트 컴퓨터의 로컬 주소를 DestinationAddressList 매개 변수가 가리키는 잠재적 대상 주소의 제공된 목록과 자동으로 페어링합니다.

SortedAddressPairList 매개 변수가 가리키는 주소 쌍의 반환된 목록은 목록의 앞부분에서 두 피어 간의 통신에 가장 적합한 주소 쌍이 발생하도록 정렬됩니다.

SortedAddressPairList 매개 변수는 다음과 같이 Ws2ipdef.h 헤더에 정의된 PSOCKADDR_IN6_PAIR 형식입니다.

    typedef struct _sockaddr_in6_pair
    {
        PSOCKADDR_IN6  SourceAddress;
        PSOCKADDR_IN6  DestinationAddress;
    } SOCKADDR_IN6_PAIR, *PSOCKADDR_IN6_PAIR;

  - **SourceAddress**  
    The IP source address.

  - **DestinationAddress**  
    The IP destination address.

요구 사항

추가 정보

FormatMessage

SOCKADDR_IN6