DnsReplaceRecordSetA, fonction (windns.h)

Article
11/20/2024

Le type de fonction DnsReplaceRecordSet remplace un jeu d’enregistrements de ressources (RR) existant. Comme de nombreuses fonctions DNS, le DnsReplaceRecordSet type de fonction est implémenté dans plusieurs formulaires pour faciliter l’encodage de caractères différent, qui est indiqué par un suffixe. En fonction de l’encodage de caractères impliqué, utilisez l’une des fonctions suivantes :

DnsReplaceRecordSetA (_A pour l’encodage ANSI)

dnsReplaceRecordSetW (_W pour l’encodage Unicode)

dnsReplaceRecordSetUTF8 (_UTF8 pour l’encodage UTF 8)

N’oubliez pas le manque de trait de soulignement entre le nom du type de fonction et son suffixe. Si le DnsReplaceRecordSet type de fonction est appelé sans son suffixe (A, W ou UTF8), une erreur du compilateur se produit.

Syntaxe

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

Paramètres

[in] pReplaceSet

Pointeur vers une structure DNS_RECORD qui contient le jeu RR qui remplace le jeu existant. Le jeu RR spécifié est remplacé par le contenu de pNewSet. Pour supprimer un jeu RR, spécifiez l’ensemble dans pNewSet, mais définissez RDATA sur NULL.

[in] Options

Valeur qui contient une bitmap d'options de mise à jour DNS. Les options peuvent être combinées et toutes les options remplacent DNS_UPDATE_SECURITY_USE_DEFAULT.

[in, optional] hContext

Handle des informations d’identification d’un compte spécifique. Utilisé lorsque la mise à jour dynamique sécurisée est requise. Ce paramètre est facultatif.

[in, out, optional] pExtraInfo

Ce paramètre est réservé pour une utilisation ultérieure et doit être défini sur NULL.

[in, out, optional] pReserved

Ce paramètre est réservé pour une utilisation ultérieure et doit être défini sur NULL.

Valeur de retour

Retourne la confirmation de réussite lors de la réussite. Sinon, retourne le code d’erreur propre au DNS approprié tel que défini dans Winerror.h.

Remarques

Note

L’en-tête windns.h définit DnsReplaceRecordSet comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	windns.h
bibliothèque	Dnsapi.lib
DLL	Dnsapi.dll

Voir aussi

DNS_RECORD

dnsModifyRecordsInSet

Partager via