DnsQueryConfig 함수(windns.h)

DnsQueryConfig 함수를 사용하면 애플리케이션 프로그래머가 로컬 컴퓨터 또는 특정 어댑터의 구성을 쿼리할 수 있습니다.

구문

DNS_STATUS DnsQueryConfig(
  [in]           DNS_CONFIG_TYPE Config,
  [in]           DWORD           Flag,
  [in, optional] PCWSTR          pwsAdapterName,
  [in, optional] PVOID           pReserved,
  [out]          PVOID           pBuffer,
  [in, out]      PDWORD          pBufLen
);

매개 변수

[in] Config

쿼리할 정보의 구성 유형을 지정하는 DNS_CONFIG_TYPE 값입니다.

[in] Flag

구성 정보에 메모리를 할당할지 여부를 지정하는 값입니다. 플래그를 DNS_CONFIG_FLAG_ALLOC 설정하여 메모리를 할당합니다. 그렇지 않으면 0으로 설정합니다.

참고LocalFree를 사용하여 할당된 메모리를 해제합니다.

 

[in, optional] pwsAdapterName

쿼리가 실행되는 어댑터 이름을 나타내는 문자열에 대한 포인터입니다.

[in, optional] pReserved

다음에 사용하도록 예약됩니다.

[out] pBuffer

쿼리 응답을 수신하는 버퍼에 대한 포인터입니다. 다음 표에는 각 Config 매개 변수 값에 대한 버퍼의 데이터 형식이 나와 있습니다.

Config 매개 변수	버퍼의 데이터 형식
DnsConfigPrimaryDomainName_W	PWCHAR
DnsConfigPrimaryDomainName_A	PCHAR
DnsConfigPrimaryDomainName_UTF8	PCHAR
DnsConfigAdapterDomainName_W	구현되지 않음
DnsConfigAdapterDomainName_A	구현되지 않음
DnsConfigAdapterDomainName_UTF8	구현되지 않음
DnsConfigDnsServerList	IP4_ARRAY
DnsConfigSearchList	구현되지 않음
DnsConfigAdapterInfo	구현되지 않음
DnsConfigPrimaryHostNameRegistrationEnabled	DWORD
DnsConfigAdapterHostNameRegistrationEnabled	DWORD
DnsConfigAddressRegistrationMaxCount	DWORD
DnsConfigHostName_W	PWCHAR
DnsConfigHostName_A	PCHAR
DnsConfigHostName_UTF8	PCHAR
DnsConfigFullHostName_W	PWCHAR
DnsConfigFullHostName_A	PCHAR
DnsConfigFullHostName_UTF8	PCHAR

[in, out] pBufLen

버퍼의 길이(바이트)입니다. 제공된 버퍼가 충분하지 않으면 오류가 반환되고 pBufferLength 에 필요한 최소 버퍼 크기가 포함됩니다. 플래그가 TRUE로 설정된 경우 입력 시 무시됩니다.

반환 값

성공적으로 완료되면 성공 확인을 반환합니다. 그렇지 않으면 Winerror.h에 정의된 적절한 DNS 관련 오류 코드를 반환합니다.

요구 사항

지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	windns.h
라이브러리	Dnsapi.lib
DLL	Dnsapi.dll

추가 정보

DNS_CONFIG_TYPE

DNS_RECORD

DnsQuery