DnsReplaceRecordSetW, fonction (windns.h)

Article
03/13/2024

Le type de fonction DnsReplaceRecordSet remplace un jeu d’enregistrements de ressources (RR) existant. Comme de nombreuses fonctions DNS, le type de fonction DnsReplaceRecordSet est implémenté dans plusieurs formes pour faciliter l’encodage de caractères différents, 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 qu’il n’y a pas de trait de soulignement entre le nom du type de fonction et son suffixe. Si le type de fonction DnsReplaceRecordSet est appelé sans son suffixe (A, W ou UTF8), une erreur du compilateur se produit.

Syntaxe

DNS_STATUS DnsReplaceRecordSetW(
  [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 l’ensemble existant. Le jeu RR spécifié est remplacé par le contenu de pNewSet. Pour supprimer un jeu RR, spécifiez le jeu dans pNewSet, mais définissez RDATA sur NULL.

[in] Options

Valeur qui contient une bitmap des 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 pour les 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 retournée

Retourne la confirmation de réussite en cas de réussite. Sinon, retourne le code d’erreur dns approprié tel que défini dans Winerror.h.

Remarques

Notes

L’en-tête windns.h définit DnsReplaceRecordSet en tant qu’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. La combinaison 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.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	windns.h
Bibliothèque	Dnsapi.lib
DLL	Dnsapi.dll

Voir aussi

DNS_RECORD

DnsModifyRecordsInSet

Partager via