DnsQueryConfig-Funktion (windns.h)

Die DnsQueryConfig-Funktion ermöglicht es Anwendungsprogrammierern, die Konfiguration des lokalen Computers oder eines bestimmten Adapters abzufragen.

Syntax

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
);

Parameter

[in] Config

Ein DNS_CONFIG_TYPE Wert, der den Konfigurationstyp der abzufragten Informationen angibt.

[in] Flag

Ein -Wert, der angibt, ob Arbeitsspeicher für die Konfigurationsinformationen zugeordnet werden soll. Legen Sie Flag auf DNS_CONFIG_FLAG_ALLOC fest, um Arbeitsspeicher zuzuweisen. Legen Sie andernfalls auf 0 fest.

Hinweis Geben Sie den zugeordneten Arbeitsspeicher mit LocalFree frei.

 

[in, optional] pwsAdapterName

Ein Zeiger auf eine Zeichenfolge, die den Adapternamen darstellt, für den die Abfrage ausgeführt wird.

[in, optional] pReserved

Für die zukünftige Verwendung reserviert.

[out] pBuffer

Ein Zeiger auf einen Puffer, der die Abfrageantwort empfängt. Die folgende Tabelle zeigt den Datentyp des Puffers für die einzelnen Config-Parameterwerte .

Konfigurationsparameter	Datentyp des Puffers
DnsConfigPrimaryDomainName_W	PWCHAR
DnsConfigPrimaryDomainName_A	PCHAR
DnsConfigPrimaryDomainName_UTF8	PCHAR
DnsConfigAdapterDomainName_W	Nicht implementiert
DnsConfigAdapterDomainName_A	Nicht implementiert
DnsConfigAdapterDomainName_UTF8	Nicht implementiert
DnsConfigDnsServerList	IP4_ARRAY
DnsConfigSearchList	Nicht implementiert
DnsConfigAdapterInfo	Nicht implementiert
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

Die Länge des Puffers in Bytes. Wenn der bereitgestellte Puffer nicht ausreicht, wird ein Fehler zurückgegeben, und pBufferLength enthält die erforderliche Mindestpuffergröße. Wird bei der Eingabe ignoriert, wenn Flag auf TRUE festgelegt ist.

Rückgabewert

Gibt die Erfolgsbestätigung nach erfolgreichem Abschluss zurück. Gibt andernfalls den entsprechenden DNS-spezifischen Fehlercode zurück, wie in Winerror.h definiert.

Anforderungen

Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	windns.h
Bibliothek	Dnsapi.lib
DLL	Dnsapi.dll

Weitere Informationen

DNS_CONFIG_TYPE

DNS_RECORD

DnsQuery