Funzione DnsReplaceRecordSetW (windns.h)

Articolo
11/20/2024

Il tipo di funzione DnsReplaceRecordSet sostituisce un set di record di risorse ESISTENTE. Analogamente a molte funzioni DNS, il DnsReplaceRecordSet tipo di funzione viene implementato in più forme per facilitare la codifica dei caratteri diversa, indicata da un suffisso. In base alla codifica dei caratteri interessata, usare una delle funzioni seguenti:

DnsReplaceRecordSetA (_A per la codifica ANSI)

DnsReplaceRecordSetW (_W per la codifica Unicode)

DnsReplaceRecordSetUTF8 (_UTF8 per la codifica UTF 8)

Tenere presente la mancanza di un carattere di sottolineatura tra il nome del tipo di funzione e il relativo suffisso. Se il DnsReplaceRecordSet tipo di funzione viene chiamato senza il relativo suffisso (A, W o UTF8), si verificherà un errore del compilatore.

Sintassi

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

Parametri

[in] pReplaceSet

Puntatore a una struttura DNS_RECORD che contiene il set RR che sostituisce il set esistente. Il set RR specificato viene sostituito con il contenuto di pNewSet. Per eliminare un set RR, specificare il set in pNewSet, ma impostare RDATA su NULL.

[in] Options

Valore che contiene una bitmap di opzioni di aggiornamento DNS . Le opzioni possono essere combinate e tutte le opzioni sostituiscono DNS_UPDATE_SECURITY_USE_DEFAULT.

[in, optional] hContext

Handle per le credenziali di un account specifico. Usato quando è necessario un aggiornamento dinamico sicuro. Questo parametro è facoltativo.

[in, out, optional] pExtraInfo

Questo parametro è riservato per uso futuro e deve essere impostato su NULL.

[in, out, optional] pReserved

Questo parametro è riservato per uso futuro e deve essere impostato su NULL.

Valore restituito

Restituisce la conferma dell'esito positivo al completamento. In caso contrario, restituisce il codice di errore specifico del DNS appropriato, come definito in Winerror.h.

Osservazioni

Nota

L'intestazione windns.h definisce DnsReplaceRecordSet come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	windns.h
libreria	Dnsapi.lib
dll	Dnsapi.dll

Vedere anche

DNS_RECORD

DnsModifyRecordsInSet

Condividi tramite