DnsReplaceRecordSetUTF8-Funktion (windns.h)

Der DnsReplaceRecordSet Funktionstyp ersetzt einen vorhandenen Ressourceneintragssatz (RR). Wie viele DNS-Funktionen wird der DnsReplaceRecordSet- Funktionstyp in mehreren Formen implementiert, um die unterschiedliche Zeichencodierung zu erleichtern, die durch ein Suffix angegeben wird. Verwenden Sie basierend auf der verwendeten Zeichencodierung eine der folgenden Funktionen:

DnsReplaceRecordSetA- (_A für DIE ANSI-Codierung)

DnsReplaceRecordSetW- (_W für Unicode-Codierung)

DnsReplaceRecordSetUTF8- (_UTF8 für UTF 8-Codierung)

Beachten Sie das Fehlen eines Unterstrichs zwischen dem Funktionstypnamen und dem Suffix. Wenn der DnsReplaceRecordSet Funktionstyp ohne suffix (A, W oder UTF8) aufgerufen wird, tritt ein Compilerfehler auf.

Syntax

DNS_STATUS DnsReplaceRecordSetUTF8(
  [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 den vorhandenen Satz ersetzt. Der angegebene RR-Satz wird durch den Inhalt pNewSetersetzt. Um einen RR-Satz zu löschen, geben Sie den Satz in pNewSet-an, legen Sie jedoch RDATA- auf NULL-fest.

[in] Options

Ein Wert, der eine Bitmap DNS-Updateoptionenenthä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 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_RECORD

DnsModifyRecordsInSet-