DnsReplaceRecordSetA-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 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 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.
Bemerkungen
Anmerkung
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 |
|---|---|
| mindestens unterstützte Client- | Windows 2000 Professional [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | windns.h |
| Library | Dnsapi.lib |
| DLL- | Dnsapi.dll |