DnsModifyRecordsInSet_W-Funktion (windns.h)

Artikel
03/04/2024

Die DnsModifyRecordsInSet-Funktion fügt einen Ressourceneintragssatz (Resource Record, RR) hinzu, ändert oder entfernt, der möglicherweise zuvor bei DNS-Servern registriert wurde.

Wie viele DNS-Funktionen wird auch der DnsModifyRecordsInSet-Funktionstyp in mehreren Formen implementiert, um eine unterschiedliche Zeichencodierung zu ermöglichen. Verwenden Sie basierend auf der betreffenden Zeichencodierung eine der folgenden Funktionen:

DnsModifyRecordsInSet_A (_A für DIE ANSI-Codierung)
DnsModifyRecordsInSet_W (_W für unicode-Codierung)
DnsModifyRecordsInSet_UTF8 (_UTF8 für UTF 8-Codierung)

Syntax

DNS_STATUS DnsModifyRecordsInSet_W(
  [in, optional]      PDNS_RECORD pAddRecords,
  [in, optional]      PDNS_RECORD pDeleteRecords,
  [in]                DWORD       Options,
  [in, optional]      HANDLE      hCredentials,
  [in, out, optional] PVOID       pExtraList,
  [in, out, optional] PVOID       pReserved
);

Parameter

[in, optional] pAddRecords

Ein Zeiger auf die DNS_RECORD-Struktur , die die RRs enthält, die dem RR-Satz hinzugefügt werden sollen.

[in, optional] pDeleteRecords

Ein Zeiger auf die DNS_RECORD-Struktur , die die aus dem RR-Satz zu löschenden RRs enthält.

[in] Options

Ein Wert, der eine Bitmap der DNS-Updateoptionen enthält. Optionen können kombiniert werden, und alle Optionen überschreiben DNS_UPDATE_SECURITY_USE_DEFAULT.

[in, optional] hCredentials

Ein Handle für die Anmeldeinformationen eines bestimmten Kontos. Wird verwendet, wenn ein sicheres dynamisches Update erforderlich ist. Dieser Parameter ist optional.

[in, out, optional] pExtraList

Dieser Parameter ist für die zukünftige Verwendung reserviert und muss auf NULL festgelegt werden.

[in, out, optional] pReserved

Dieser Parameter ist für die zukünftige Verwendung reserviert und muss auf NULL festgelegt werden.

Rückgabewert

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

Hinweise

Der Funktionstyp DnsModifyRecordsInSet wird in den folgenden Schritten ausgeführt.

In pDeleteRecords angegebene Datensätze werden gelöscht. Wenn pDeleteRecords leer ist oder keine Datensätze enthält, die im aktuellen Satz vorhanden sind, geht die DnsModifyRecordsInSet-Funktion mit dem nächsten Schritt fort.
In pAddRecords angegebene Datensätze werden hinzugefügt. Wenn pAddRecords leer ist, wird der Vorgang ohne Hinzufügen von Datensätzen abgeschlossen.

Um einen neuen Datensatz hinzuzufügen, geben Sie keine Datensätze in pDeleteRecords an, und geben Sie den Datensatz an, der in pAddRecords hinzugefügt werden soll. Um einen Datensatz zu ändern, geben Sie den Datensatz an, der in pDeleteRecords geändert wird, und fügen Sie dann die geänderte Version dieses Datensatzes hinzu, indem Sie ihn in pAddRecords platzieren. Um Datensätze zu löschen, geben Sie nur Datensätze an, die gelöscht werden sollen. Mehrere Datensätze können in einem einzelnen Aufruf von DnsModifyRecordsInSet hinzugefügt oder gelöscht werden. Der Wert des pName-Members in jedem DNS_RECORD muss jedoch identisch sein, sonst schlägt der Aufruf fehl. Wenn ein in pAddRecords angegebener Datensatz bereits vorhanden ist, erfolgt keine Änderung.

Wenn keine Serverliste angegeben ist, wird der Standardnameserver abgefragt.

Anforderungen

Anforderung	Wert
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

Weitere Informationen

DNS_RECORD

DnsQuery

DnsReplaceRecordSet

Freigeben über