Função DnsReplaceRecordSetUTF8 (windns.h)
O tipo de função DnsReplaceRecordSet substitui um conjunto de RR (registro de recurso) existente. Como muitas funções DNS, o tipo de função DnsReplaceRecordSet é implementado em várias formas para facilitar a codificação de caracteres diferente, que é indicada por um sufixo. Com base na codificação de caracteres envolvida, use uma das seguintes funções:
DnsReplaceRecordSetA (_A para codificação ANSI)
DnsReplaceRecordSetW (_W para codificação Unicode)
DnsReplaceRecordSetUTF8 (_UTF8 para codificação UTF 8)
Lembre-se da falta de um sublinhado entre o nome do tipo de função e seu sufixo. Se o tipo de função DnsReplaceRecordSet for chamado sem seu sufixo (A, W ou UTF8), ocorrerá um erro do compilador.
Sintaxe
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
Um ponteiro para uma estrutura DNS_RECORD que contém o conjunto RR que substitui o conjunto existente. O conjunto de RR especificado é substituído pelo conteúdo de pNewSet. Para excluir um conjunto de RR, especifique o conjunto em pNewSet, mas defina RDATA como NULL.
[in] Options
Um valor que contém um bitmap de Opções de Atualização DNS. As opções podem ser combinadas e todas as opções substituem DNS_UPDATE_SECURITY_USE_DEFAULT.
[in, optional] hContext
O identificador para as credenciais de uma conta específica. Usado quando a atualização dinâmica segura é necessária. Esse parâmetro é opcional.
[in, out, optional] pExtraInfo
Esse parâmetro é reservado para uso futuro e deve ser definido como NULL.
[in, out, optional] pReserved
Esse parâmetro é reservado para uso futuro e deve ser definido como NULL.
Valor retornado
Retorna a confirmação de êxito após a conclusão bem-sucedida. Caso contrário, retorna o código de erro específico do DNS apropriado, conforme definido em Winerror.h.
Requisitos
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | windns.h |
| Biblioteca | Dnsapi.lib |
| DLL | Dnsapi.dll |