[PSDK] Apply our header formatting style on windns.h. NFC.

svn path=/trunk/; revision=66431

reactos/include/psdk/windns.h

@@ -1,5 +1,5 @@
-#ifndef _WINDNS_H
+#ifndef _WINDNS_INCLUDED_
-#define _WINDNS_H
+#define _WINDNS_INCLUDED_
 
 #ifdef __cplusplus
 extern "C" {
@@ -32,10 +32,12 @@ extern "C" {
 #define DNS_CONFIG_FLAG_ALLOC TRUE
 
 #ifndef RC_INVOKE
-typedef DWORD IP4_ADDRESS;
-typedef _Return_type_success_(return == 0) DWORD DNS_STATUS;
-#define DNS_TYPE_ZERO       0x0000
 
+typedef DWORD IP4_ADDRESS;
+
+typedef _Return_type_success_(return == 0) DWORD DNS_STATUS;
+
+#define DNS_TYPE_ZERO    0x0000
 #define DNS_TYPE_A       0x0001
 #define DNS_TYPE_NS      0x0002
 #define DNS_TYPE_MD      0x0003
@@ -95,15 +97,21 @@ typedef _Return_type_success_(return == 0) DWORD DNS_STATUS;
 #define DNS_TYPE_WINSR  0xff02
 #define DNS_TYPE_NBSTAT (DNS_TYPE_WINSR)
 
-typedef enum _DNS_CHARSET
+#define DNSREC_QUESTION   0
-{
+#define DNSREC_ANSWER     1
+#define DNSREC_AUTHORITY  2
+#define DNSREC_ADDITIONAL 3
+
+#define DNS_ATMA_MAX_ADDR_LENGTH 20
+
+typedef enum _DNS_CHARSET {
   DnsCharSetUnknown,
   DnsCharSetUnicode,
   DnsCharSetUtf8,
   DnsCharSetAnsi
 } DNS_CHARSET;
-typedef enum
+
-{
+typedef enum {
   DnsConfigPrimaryDomainName_W,
   DnsConfigPrimaryDomainName_A,
   DnsConfigPrimaryDomainName_UTF8,
@@ -123,14 +131,14 @@ typedef enum
   DnsConfigFullHostName_A,
   DnsConfigFullHostName_UTF8
 } DNS_CONFIG_TYPE;
-typedef enum
+
-{
+typedef enum {
   DnsFreeFlat = 0,
   DnsFreeRecordList,
   DnsFreeParsedMessageFields
 } DNS_FREE_TYPE;
-typedef enum _DNS_NAME_FORMAT
+
-{
+typedef enum _DNS_NAME_FORMAT {
   DnsNameDomain,
   DnsNameDomainLabel,
   DnsNameHostnameFull,
@@ -138,17 +146,19 @@ typedef enum _DNS_NAME_FORMAT
   DnsNameWildcard,
   DnsNameSrvRecord
 } DNS_NAME_FORMAT;
-typedef enum
+
-{
+typedef enum {
   DnsSectionQuestion,
   DnsSectionAnswer,
   DnsSectionAuthority,
   DnsSectionAdditional
 } DNS_SECTION;
+
 typedef struct _IP4_ARRAY {
   DWORD AddrCount;
   IP4_ADDRESS AddrArray[1];
 } IP4_ARRAY, *PIP4_ARRAY;
+
 typedef struct {
   DWORD IP6Dword[4];
 } IP6_ADDRESS, *PIP6_ADDRESS, DNS_IP6_ADDRESS, *PDNS_IP6_ADDRESS;
@@ -191,6 +201,7 @@ typedef struct _DNS_MESSAGE_BUFFER {
   DNS_HEADER MessageHead;
   CHAR MessageBody[1];
 } DNS_MESSAGE_BUFFER, *PDNS_MESSAGE_BUFFER;
+
 typedef struct _DnsRecordFlags {
   DWORD Section:2;
   DWORD Delete:1;
@@ -198,27 +209,27 @@ typedef struct _DnsRecordFlags {
   DWORD Unused:3;
   DWORD Reserved:24;
 } DNS_RECORD_FLAGS;
-#define DNSREC_QUESTION 0
+
-#define DNSREC_ANSWER 1
-#define DNSREC_AUTHORITY 2
-#define DNSREC_ADDITIONAL 3
 typedef struct {
   IP4_ADDRESS IpAddress;
 } DNS_A_DATA, *PDNS_A_DATA;
+
 typedef struct {
   DNS_IP6_ADDRESS Ip6Address;
 } DNS_AAAA_DATA, *PDNS_AAAA_DATA;
-#define DNS_ATMA_MAX_ADDR_LENGTH 20
+
 typedef struct {
   BYTE AddressType;
   BYTE Address[DNS_ATMA_MAX_ADDR_LENGTH];
 } DNS_ATMA_DATA, *PDNS_ATMA_DATA;
+
 typedef struct {
   WORD wFlags;
   BYTE chProtocol;
   BYTE chAlgorithm;
   BYTE Key[1];
 } DNS_KEY_DATA, *PDNS_KEY_DATA;
+
 typedef struct {
   WORD wVersion;
   WORD wSize;
@@ -228,44 +239,54 @@ typedef struct {
   DWORD dwLongitude;
   DWORD dwAltitude;
 } DNS_LOC_DATA, *PDNS_LOC_DATA;
+
 typedef struct {
   LPSTR pNameMailbox;
   LPSTR pNameErrorsMailbox;
 } DNS_MINFO_DATAA, *PDNS_MINFO_DATAA;
+
 typedef struct {
   LPWSTR pNameMailbox;
   LPWSTR pNameErrorsMailbox;
 } DNS_MINFO_DATAW, *PDNS_MINFO_DATAW;
+
 typedef struct {
   LPSTR pNameExchange;
   WORD wPreference;
   WORD Pad;
 } DNS_MX_DATAA, *PDNS_MX_DATAA;
+
 typedef struct {
   LPWSTR pNameExchange;
   WORD wPreference;
   WORD Pad;
 } DNS_MX_DATAW, *PDNS_MX_DATAW;
+
 typedef struct {
   DWORD dwByteCount;
   BYTE Data[1];
 } DNS_NULL_DATA, *PDNS_NULL_DATA;
+
 typedef struct {
   LPSTR pNameNext;
   WORD wNumTypes;
   WORD wTypes[1];
 } DNS_NXT_DATAA, *PDNS_NXT_DATAA;
+
 typedef struct {
   LPWSTR pNameNext;
   WORD wNumTypes;
   WORD wTypes[1];
 } DNS_NXT_DATAW, *PDNS_NXT_DATAW;
+
 typedef struct {
   LPSTR pNameHost;
 } DNS_PTR_DATAA, *PDNS_PTR_DATAA;
+
 typedef struct {
   LPWSTR pNameHost;
 } DNS_PTR_DATAW, *PDNS_PTR_DATAW;
+
 typedef struct {
   LPSTR pNameSigner;
   WORD wTypeCovered;
@@ -278,6 +299,7 @@ typedef struct {
   WORD Pad;
   BYTE Signature[1];
 } DNS_SIG_DATAA, *PDNS_SIG_DATAA;
+
 typedef struct {
   LPWSTR pNameSigner;
   WORD wTypeCovered;
@@ -290,6 +312,7 @@ typedef struct {
   WORD Pad;
   BYTE Signature[1];
 } DNS_SIG_DATAW, *PDNS_SIG_DATAW;
+
 typedef struct {
   LPSTR pNamePrimaryServer;
   LPSTR pNameAdministrator;
@@ -299,6 +322,7 @@ typedef struct {
   DWORD dwExpire;
   DWORD dwDefaultTtl;
 } DNS_SOA_DATAA, *PDNS_SOA_DATAA;
+
 typedef struct {
   LPWSTR pNamePrimaryServer;
   LPWSTR pNameAdministrator;
@@ -308,6 +332,7 @@ typedef struct {
   DWORD dwExpire;
   DWORD dwDefaultTtl;
 } DNS_SOA_DATAW, *PDNS_SOA_DATAW;
+
 typedef struct {
   LPSTR pNameTarget;
   WORD wPriority;
@@ -315,6 +340,7 @@ typedef struct {
   WORD wPort;
   WORD Pad;
 } DNS_SRV_DATAA, *PDNS_SRV_DATAA;
+
 typedef struct {
   LPWSTR pNameTarget;
   WORD wPriority;
@@ -322,14 +348,17 @@ typedef struct {
   WORD wPort;
   WORD Pad;
 } DNS_SRV_DATAW, *PDNS_SRV_DATAW;
+
 typedef struct {
   DWORD dwStringCount;
   LPSTR pStringArray[1];
 } DNS_TXT_DATAA, *PDNS_TXT_DATAA;
+
 typedef struct {
   DWORD dwStringCount;
   LPWSTR pStringArray[1];
 } DNS_TXT_DATAW, *PDNS_TXT_DATAW;
+
 typedef struct {
   LPSTR pNameAlgorithm;
   PBYTE pAlgorithmPacket;
@@ -344,6 +373,7 @@ typedef struct {
   UCHAR cAlgNameLength;
   BOOL bPacketPointers;
 } DNS_TKEY_DATAA, *PDNS_TKEY_DATAA;
+
 typedef struct {
   LPWSTR pNameAlgorithm;
   PBYTE pAlgorithmPacket;
@@ -358,6 +388,7 @@ typedef struct {
   UCHAR cAlgNameLength;
   BOOL bPacketPointers;
 } DNS_TKEY_DATAW, *PDNS_TKEY_DATAW;
+
 typedef struct {
   LPSTR pNameAlgorithm;
   PBYTE pAlgorithmPacket;
@@ -372,6 +403,7 @@ typedef struct {
   UCHAR cAlgNameLength;
   BOOL bPacketPointers;
 } DNS_TSIG_DATAA, *PDNS_TSIG_DATAA;
+
 typedef struct {
   LPWSTR pNameAlgorithm;
   PBYTE pAlgorithmPacket;
@@ -386,6 +418,7 @@ typedef struct {
   UCHAR cAlgNameLength;
   BOOL bPacketPointers;
 } DNS_TSIG_DATAW, *PDNS_TSIG_DATAW;
+
 typedef struct {
   DWORD dwMappingFlag;
   DWORD dwLookupTimeout;
@@ -393,12 +426,14 @@ typedef struct {
   DWORD cWinsServerCount;
   IP4_ADDRESS WinsServers[1];
 } DNS_WINS_DATA, *PDNS_WINS_DATA;
+
 typedef struct {
   DWORD dwMappingFlag;
   DWORD dwLookupTimeout;
   DWORD dwCacheTimeout;
   LPSTR pNameResultDomain;
 } DNS_WINSR_DATAA, *PDNS_WINSR_DATAA;
+
 typedef struct {
   DWORD dwMappingFlag;
   DWORD dwLookupTimeout;
@@ -411,6 +446,7 @@ typedef struct {
   UCHAR chProtocol;
   BYTE BitMask[1];
 } DNS_WKS_DATA, *PDNS_WKS_DATA;
+
 typedef struct _DnsRecordA {
   struct _DnsRecordA* pNext;
   LPSTR pName;
@@ -425,8 +461,7 @@ typedef struct _DnsRecordA {
   union {
     DNS_A_DATA A;
     DNS_SOA_DATAA SOA, Soa;
-		DNS_PTR_DATAA PTR, Ptr, NS, Ns, CNAME, Cname, MB, Mb,
+    DNS_PTR_DATAA PTR, Ptr, NS, Ns, CNAME, Cname, MB, Mb, MD, Md, MF, Mf, MG, Mg, MR, Mr;
-			      MD, Md, MF, Mf, MG, Mg, MR, Mr;
     DNS_MINFO_DATAA MINFO, Minfo, RP, Rp;
     DNS_MX_DATAA MX, Mx, AFSDB, Afsdb, RT, Rt;
     DNS_TXT_DATAA HINFO, Hinfo, ISDN, Isdn, TXT, Txt, X25;
@@ -444,6 +479,7 @@ typedef struct _DnsRecordA {
     DNS_WINSR_DATAA WINSR, WinsR, NBSTAT, Nbstat;
   } Data;
 } DNS_RECORDA, *PDNS_RECORDA;
+
 typedef struct _DnsRecordW {
   struct _DnsRecordW* pNext;
   LPWSTR pName;
@@ -458,8 +494,7 @@ typedef struct _DnsRecordW {
   union {
     DNS_A_DATA A;
     DNS_SOA_DATAW SOA, Soa;
-		DNS_PTR_DATAW PTR, Ptr, NS, Ns, CNAME, Cname, MB, Mb,
+    DNS_PTR_DATAW PTR, Ptr, NS, Ns, CNAME, Cname, MB, Mb, MD, Md, MF, Mf, MG, Mg, MR, Mr;
-			      MD, Md, MF, Mf, MG, Mg, MR, Mr;
     DNS_MINFO_DATAW MINFO, Minfo, RP, Rp;
     DNS_MX_DATAW MX, Mx, AFSDB, Afsdb, RT, Rt;
     DNS_TXT_DATAW HINFO, Hinfo, ISDN, Isdn, TXT, Txt, X25;
@@ -570,8 +605,17 @@ DnsModifyRecordsInSet_UTF8(
   _Inout_opt_ PIP4_ARRAY pExtraList,
   _Inout_opt_ PVOID pReserved);
 
-BOOL WINAPI DnsNameCompare_A(_In_ PCSTR, _In_ PCSTR);
+BOOL
-BOOL WINAPI DnsNameCompare_W(_In_ PCWSTR, _In_ PCWSTR);
+WINAPI
+DnsNameCompare_A(
+  _In_ PCSTR,
+  _In_ PCSTR);
+
+BOOL
+WINAPI
+DnsNameCompare_W(
+  _In_ PCWSTR,
+  _In_ PCWSTR);
 
 DNS_STATUS
 WINAPI
@@ -613,7 +657,11 @@ DnsQueryConfig(
   _Out_writes_bytes_to_opt_(*pBufLen, *pBufLen) PVOID pBuffer,
   _Inout_ PDWORD pBufLen);
 
-BOOL WINAPI DnsRecordCompare(_In_ PDNS_RECORD, _In_ PDNS_RECORD);
+BOOL
+WINAPI
+DnsRecordCompare(
+  _In_ PDNS_RECORD,
+  _In_ PDNS_RECORD);
 
 PDNS_RECORD
 WINAPI
@@ -622,7 +670,11 @@ DnsRecordCopyEx(
   _In_ DNS_CHARSET CharSetIn,
   _In_ DNS_CHARSET CharSetOut);
 
-void WINAPI DnsRecordListFree(_Inout_opt_ PDNS_RECORD, _In_ DNS_FREE_TYPE);
+void
+WINAPI
+DnsRecordListFree(
+  _Inout_opt_ PDNS_RECORD,
+  _In_ DNS_FREE_TYPE);
 
 BOOL
 WINAPI
@@ -639,8 +691,15 @@ DnsRecordSetCopyEx(
   _In_ DNS_CHARSET CharSetIn,
   _In_ DNS_CHARSET CharSetOut);
 
-PDNS_RECORD WINAPI DnsRecordSetDetach(_Inout_ PDNS_RECORD);
+PDNS_RECORD
-void WINAPI DnsReleaseContextHandle(_In_ HANDLE);
+WINAPI
+DnsRecordSetDetach(
+  _Inout_ PDNS_RECORD);
+
+void
+WINAPI
+DnsReleaseContextHandle(
+  _In_ HANDLE);
 
 DNS_STATUS
 WINAPI
@@ -669,9 +728,23 @@ DnsReplaceRecordSetUTF8(
   _Inout_opt_ PIP4_ARRAY pExtraInfo,
   _Inout_opt_ PVOID pReserved);
 
-DNS_STATUS WINAPI DnsValidateName_A(_In_ LPCSTR, _In_ DNS_NAME_FORMAT);
+DNS_STATUS
-DNS_STATUS WINAPI DnsValidateName_W(_In_ LPCWSTR, _In_ DNS_NAME_FORMAT);
+WINAPI
-DNS_STATUS WINAPI DnsValidateName_UTF8(_In_ LPCSTR, _In_ DNS_NAME_FORMAT);
+DnsValidateName_A(
+  _In_ LPCSTR,
+  _In_ DNS_NAME_FORMAT);
+
+DNS_STATUS
+WINAPI
+DnsValidateName_W(
+  _In_ LPCWSTR,
+  _In_ DNS_NAME_FORMAT);
+
+DNS_STATUS
+WINAPI
+DnsValidateName_UTF8(
+  _In_ LPCSTR,
+  _In_ DNS_NAME_FORMAT);
 
 BOOL
 WINAPI
@@ -694,6 +767,7 @@ DnsWriteQuestionToBuffer_UTF8(
   _In_ BOOL fRecursionDesired);
 
 #ifdef UNICODE
+
 #define DNS_MINFO_DATA DNS_MINFO_DATAW
 #define PDNS_MINFO_DATA PDNS_MINFO_DATAW
 #define DNS_MX_DATA DNS_MX_DATAW
@@ -718,7 +792,9 @@ DnsWriteQuestionToBuffer_UTF8(
 #define DnsQuery DnsQuery_W
 #define DnsReplaceRecordSet DnsReplaceRecordSetW
 #define DnsValidateName DnsValidateName_W
-#else
+
+#else /* UNICODE */
+
 #define DNS_MINFO_DATA DNS_MINFO_DATAA
 #define PDNS_MINFO_DATA PDNS_MINFO_DATAA
 #define DNS_MX_DATA DNS_MX_DATAA
@@ -743,7 +819,8 @@ DnsWriteQuestionToBuffer_UTF8(
 #define DnsQuery DnsQuery_A
 #define DnsReplaceRecordSet DnsReplaceRecordSetA
 #define DnsValidateName DnsValidateName_A
-#endif
+
+#endif /* UNICODE */
 
 #endif /* RC_INVOKED */
 
@@ -751,4 +828,4 @@ DnsWriteQuestionToBuffer_UTF8(
 }
 #endif
 
-#endif /* _WINDNS_H */
+#endif /* _WINDNS_INCLUDED_ */