DnsGetApplicationSettings-Funktion (windns.h)
Ruft die DNS-Einstellungen pro Anwendung ab.
Syntax
DWORD DnsGetApplicationSettings(
DWORD *pcServers,
DNS_CUSTOM_SERVER **ppDefaultServers,
DNS_APPLICATION_SETTINGS *pSettings
);
Parameter
pcServers
Typ: _Out_DWORD-*
Nach dem Funktionsaufruf verweist dies auf die Anzahl der benutzerdefinierten DNS-Server, die die Anwendung konfiguriert hat. Wenn keine benutzerdefinierten Server konfiguriert sind oder wenn die Funktion fehlschlägt, wird dies auf 0 festgelegt.
ppDefaultServers
Typ: _Outptr_result_buffer_(*pcServers) DNS_CUSTOM_SERVER**
Nach dem Funktionsaufruf verweist dies auf das Array von benutzerdefinierten DNS-Servern, die für die Anwendung konfiguriert sind. Wenn die Anwendung keine Server konfiguriert hat oder wenn die Funktion fehlschlägt, wird dies auf NULL-festgelegt.
pSettings
Typ: _Out_opt_ DNS_APPLICATION_SETTINGS*
Ein Zeiger auf ein DNS_APPLICATION_SETTINGS-Objekt, aufgefüllt mit den Anwendungseinstellungen.
Rückgabewert
Ein DWORD- mit ERROR_SUCCESS bei Erfolg oder fehlercode bei Fehlern.
Bemerkungen
Um Speicherverluste zu vermeiden, müssen Sie DnsFreeCustomServers auf den Servern aufrufen, die von DnsGetApplicationSettings über den pSettings Parameter zurückgegeben werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows Build 22000 |
| mindestens unterstützte Server- | Windows Build 22000 |
| Zielplattform- | Fenster |
| Header- | windns.h |
| Library | Dnsapi.lib |
| DLL- | Dnsapi.dll |