Función DnsReplaceRecordSetA (windns.h)
El tipo de función DnsReplaceRecordSet reemplaza a un conjunto de registros de recursos (RR) existente. 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 su sufijo (A, W o UTF8), se producirá un error del compilador.
Sintaxis
DNS_STATUS DnsReplaceRecordSetA(
[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 de 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.
Comentarios
Nota
El encabezado windns.h define DnsReplaceRecordSet como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.
Requisitos
| Requisito | Value |
|---|---|
| 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 |