DnsQueryConfig-Funktion (windns.h)
Mit der DnsQueryConfig--Funktion können Anwendungsprogrammierer die Konfiguration des lokalen Computers oder eines bestimmten Adapters abfragen.
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
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.
[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.
Gibt eine Erfolgsbestätigung nach erfolgreichem Abschluss zurück. Andernfalls wird der entsprechende DNS-spezifische Fehlercode wie in Winerror.h definiert zurückgegeben.
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 |