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.

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

[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

Siehe auch

DNS_CONFIG_TYPE

DNS_RECORD

DnsQuery-