DnsServiceConstructInstance 함수(windns.h)

이를 설명하는 데이터에서 DNS_SERVICE_INSTANCE 구조를 빌드하는 데 사용됩니다.

구문

PDNS_SERVICE_INSTANCE DnsServiceConstructInstance(
  PCWSTR       pServiceName,
  PCWSTR       pHostName,
  PIP4_ADDRESS pIp4,
  PIP6_ADDRESS pIp6,
  WORD         wPort,
  WORD         wPriority,
  WORD         wWeight,
  DWORD        dwPropertiesCount,
  PCWSTR       *keys,
  PCWSTR       *values
);

매개 변수

pServiceName

서비스의 이름을 나타내는 문자열입니다.

pHostName

서비스 호스트의 이름을 나타내는 문자열입니다.

pIp4

서비스 관련 IPv4 주소를 나타내는 IP4_ADDRESS 구조체에 대한 포인터입니다.

pIp6

서비스 관련 IPv6 주소를 나타내는 IP6_ADDRESS 구조체에 대한 포인터입니다.

wPort

서비스가 실행 중인 포트를 나타내는 값입니다.

wPriority

서비스 우선 순위를 나타내는 값입니다.

wWeight

서비스 가중치를 나타내는 값입니다.

dwPropertiesCount

속성 수 - 및 values 매개 변수의 배열에 있는 요소 수를 keys 정의합니다.

keys

속성 키를 나타내는 문자열 값 배열에 대한 포인터입니다.

values

해당 속성 값을 나타내는 문자열 값 배열에 대한 포인터입니다.

반환 값

전달된 매개 변수에서 빌드된 새로 할당된 DNS_SERVICE_INSTANCE 구조체에 대한 포인터입니다. 애플리케이션은 DnsServiceFreeInstance를 호출하여 연결된 메모리를 해제해야 합니다.

설명

반환된 구조체의 dwInterfaceIndex 필드는 0으로 설정됩니다.

요구 사항

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