Función DnsReplaceRecordSetUTF8 (windns.h)

El tipo de función DnsReplaceRecordSet reemplaza un registro de recursos (RR) existente establecido. Al igual que muchas funciones DNS, el tipo de función DnsReplaceRecordSet se implementa en varios formularios para facilitar la codificación de caracteres diferente, que se indica mediante un sufijo. En función de la codificación de caracteres implicada, use una de las siguientes funciones:

DnsReplaceRecordSetA (_A para la codificación ANSI)

DnsReplaceRecordSetW (_W para la codificación Unicode)

DnsReplaceRecordSetUTF8 (_UTF8 para la codificación UTF 8)

Tenga en cuenta la falta de un carácter de subrayado entre el nombre del tipo de función y su sufijo. Si se llama al tipo de función DnsReplaceRecordSet sin sufijo (A, W o UTF8), se producirá un error del compilador.

Sintaxis

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

Parámetros

[in] pReplaceSet

Puntero a una estructura DNS_RECORD que contiene el conjunto RR que reemplaza al conjunto existente. El conjunto rr especificado se reemplaza por el contenido de pNewSet. Para eliminar un conjunto rr, especifique el conjunto en pNewSet, pero establezca RDATA en NULL.

[in] Options

Valor que contiene un mapa de bits de las opciones de actualización de DNS. Las opciones se pueden combinar y todas las opciones invalidan DNS_UPDATE_SECURITY_USE_DEFAULT.

[in, optional] hContext

Identificador de las credenciales de una cuenta específica. Se usa cuando se requiere una actualización dinámica segura. Este parámetro es opcional.

[in, out, optional] pExtraInfo

Este parámetro está reservado para uso futuro y debe establecerse en NULL.

[in, out, optional] pReserved

Este parámetro está reservado para uso futuro y debe establecerse en NULL.

Valor devuelto

Devuelve la confirmación correcta tras la finalización correcta. De lo contrario, devuelve el código de error específico de DNS adecuado, tal como se define en Winerror.h.

Requisitos

Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	windns.h
Library	Dnsapi.lib
Archivo DLL	Dnsapi.dll

Consulte también

DNS_RECORD

DnsModifyRecordsInSet