DnsReplaceRecordSetA-Funktion (windns.h)

  • Artikel

Der Funktionstyp DnsReplaceRecordSet ersetzt einen vorhandenen Ressourcendatensatz (RR). Wie viele andere DNS-Funktionen wird auch der Funktionstyp DnsReplaceRecordSet in mehreren Formen implementiert, um eine unterschiedliche Zeichencodierung zu ermöglichen, die durch ein Suffix angegeben wird. Verwenden Sie basierend auf der beteiligten Zeichencodierung eine der folgenden Funktionen:

DnsReplaceRecordSetA (_A für ANSI-Codierung)

DnsReplaceRecordSetW (_W für Unicode-Codierung)

DnsReplaceRecordSetUTF8 (_UTF8 für UTF 8-Codierung)

Beachten Sie, dass zwischen dem Funktionstypnamen und dem Suffix kein Unterstrich vorhanden ist. Wenn der Funktionstyp DnsReplaceRecordSet ohne sein Suffix (A, W oder UTF8) aufgerufen wird, tritt ein Compilerfehler auf.

Syntax

DNS_STATUS DnsReplaceRecordSetA(
  [in]                PDNS_RECORD pReplaceSet,
  [in]                DWORD       Options,
  [in, optional]      HANDLE      hContext,
  [in, out, optional] PVOID       pExtraInfo,
  [in, out, optional] PVOID       pReserved
);

Parameter

[in] pReplaceSet

Ein Zeiger auf eine DNS_RECORD-Struktur , die den RR-Satz enthält, der die vorhandene Menge ersetzt. Der angegebene RR-Satz wird durch den Inhalt von pNewSet ersetzt. Um einen RR-Satz zu löschen, geben Sie den Satz in pNewSet an, legen Sie RDATA jedoch auf NULL fest.

[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] hContext

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

[in, out, optional] pExtraInfo

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. Gibt andernfalls den entsprechenden DNS-spezifischen Fehlercode zurück, wie in Winerror.h definiert.

Hinweise

Hinweis

Der windns.h-Header definiert DnsReplaceRecordSet als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

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

DnsModifyRecordsInSet