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 |