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.
[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 |