DnsReplaceRecordSetW-Funktion (windns.h)
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 DnsReplaceRecordSetW(
[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 |