DnsReplaceRecordSetA, fonction (windns.h)

Article
03/04/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é sous 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 l’absence 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 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 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 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é à une utilisation ultérieure et doit être défini sur NULL.

[in, out, optional] pReserved

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

Valeur retournée

Retourne la confirmation de réussite en cas d’achèvement réussi. 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 comme un 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.

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