DnsModifyRecordsInSet_A 함수(windns.h)
DnsModifyRecordsInSet 함수는 이전에 DNS 서버에 등록되었을 수 있는 RR(리소스 레코드) 집합을 추가, 수정 또는 제거합니다.
많은 DNS 함수와 마찬가지로 DnsModifyRecordsInSet 함수 형식은 다양한 문자 인코딩을 용이하게 하기 위해 여러 형식으로 구현됩니다. 관련된 문자 인코딩에 따라 다음 함수 중 하나를 사용합니다.
- DNSMODIFYRECORDSINSET_A (ANSI 인코딩에 대한 _A)
- DnsModifyRecordsInSet_W (유니코드 인코딩에 대한 _W)
- DnsModifyRecordsInSet_UTF8 (UTF 8 인코딩의 경우 _UTF8)
구문
DNS_STATUS DnsModifyRecordsInSet_A(
[in, optional] PDNS_RECORD pAddRecords,
[in, optional] PDNS_RECORD pDeleteRecords,
[in] DWORD Options,
[in, optional] HANDLE hCredentials,
[in, out, optional] PVOID pExtraList,
[in, out, optional] PVOID pReserved
);
매개 변수
[in, optional] pAddRecords
RR 집합에 추가할 RR 을 포함하는 DNS_RECORD 구조체에 대한 포인터입니다.
[in, optional] pDeleteRecords
RR 집합에서 삭제할 RR을 포함하는 DNS_RECORD 구조체에 대한 포인터입니다.
[in] Options
DNS 업데이트 옵션의 비트맵을 포함하는 값입니다. 옵션을 결합할 수 있으며 모든 옵션은 DNS_UPDATE_SECURITY_USE_DEFAULT 재정의할 수 있습니다.
[in, optional] hCredentials
특정 계정의 자격 증명에 대한 핸들입니다. 보안 동적 업데이트가 필요할 때 사용됩니다. 이 매개 변수는 선택적 요소입니다.
[in, out, optional] pExtraList
이 매개 변수는 나중에 사용하도록 예약되어 있으며 NULL로 설정해야 합니다.
[in, out, optional] pReserved
이 매개 변수는 나중에 사용하도록 예약되어 있으며 NULL로 설정해야 합니다.
반환 값
성공적으로 완료되면 성공 확인을 반환합니다. 그렇지 않으면 Winerror.h에 정의된 적절한 DNS 관련 오류 코드를 반환합니다.
설명
DnsModifyRecordsInSet 함수 형식은 다음 단계에서 실행됩니다.
- pDeleteRecords에 지정된 레코드가 삭제됩니다. pDeleteRecords가 비어 있거나 현재 집합에 있는 레코드가 없는 경우 DnsModifyRecordsInSet 함수는 다음 단계로 이동합니다.
- pAddRecords에 지정된 레코드가 추가됩니다. pAddRecords가 비어 있으면 레코드를 추가하지 않고 작업이 완료됩니다.
서버 목록을 지정하지 않으면 기본 이름 서버가 쿼리됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | windns.h |
| 라이브러리 | Dnsapi.lib |
| DLL | Dnsapi.dll |