Auf Englisch lesen

Freigeben über


DnsQueryConfig-Funktion (windns.h)

Mit der DnsQueryConfig--Funktion können Anwendungsprogrammierer die Konfiguration des lokalen Computers oder eines bestimmten Adapters abfragen.

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 abzufragenden Informationen angibt.

[in] Flag

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

Hinweis Geben Sie den zugewiesenen Speicher mit LocalFreefrei.
 

[in, optional] pwsAdapterName

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

[in, optional] pReserved

Reserviert für die zukünftige Verwendung.

[out] pBuffer

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

Config-Parameter 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 Byte. Wenn der bereitgestellte Puffer nicht ausreicht, wird ein Fehler zurückgegeben, und pBufferLength- die minimale erforderliche Puffergröße enthält. Wird bei Eingaben ignoriert, wenn Flag- auf TRUE-festgelegt ist.

Rückgabewert

Gibt eine Erfolgsbestätigung nach erfolgreichem Abschluss zurück. Andernfalls wird der entsprechende DNS-spezifische Fehlercode wie in Winerror.h definiert zurückgegeben.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server- Windows 2000 Server [nur Desktop-Apps]
Zielplattform- Fenster
Header- windns.h
Library Dnsapi.lib
DLL- Dnsapi.dll

Siehe auch

DNS_CONFIG_TYPE

DNS_RECORD

DnsQuery-