DnsReplaceRecordSetUTF8, fonction (windns.h)

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 DnsReplaceRecordSetUTF8(
  [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.

Configuration requise

Voir aussi

DNS_RECORD

DnsModifyRecordsInSet