DnsModifyRecordsInSet_A-Funktion (windns.h)

  • Artikel

Mit der DnsModifyRecordsInSet-Funktion wird ein Ressourceneintragssatz (RR) hinzugefügt, geändert oder entfernt, der möglicherweise zuvor bei DNS-Servern registriert wurde.

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

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

Syntax

DNS_STATUS DnsModifyRecordsInSet_A(
  [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 die Erfolgsbestätigung nach erfolgreichem Abschluss zurück. Andernfalls wird der entsprechende DNS-spezifische Fehlercode zurückgegeben, wie in Winerror.h definiert.

Hinweise

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

  1. In pDeleteRecords angegebene Datensätze werden gelöscht. Wenn pDeleteRecords leer ist oder keine Datensätze enthält, die im aktuellen Satz vorhanden sind, wechselt die DnsModifyRecordsInSet-Funktion zum nächsten Schritt.
  2. Datensätze, die in pAddRecords angegeben sind, werden hinzugefügt. Wenn pAddRecords leer ist, wird der Vorgang abgeschlossen, ohne Datensätze hinzuzufügen.
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. Geben Sie zum Löschen von Datensätzen nur zu löschende Datensätze an. Mehrere Datensätze können in einem einzigen Aufruf von DnsModifyRecordsInSet hinzugefügt oder gelöscht werden. Der Wert des pName-Elements in jedem DNS_RECORD muss jedoch gleich sein, andernfalls schlägt der Aufruf fehl. Wenn ein in pAddRecords angegebener Datensatz bereits vorhanden ist, erfolgt keine Änderung.

Wenn keine Serverliste angegeben ist, wird der Standardnamenserver 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