[PSDK]

* Annotate windns.h.
CORE-7474

svn path=/trunk/; revision=60253

reactos/include/psdk/windns.h

@@ -33,7 +33,7 @@ extern "C" {
 
 #ifndef RC_INVOKE
 typedef DWORD IP4_ADDRESS;
-typedef DWORD DNS_STATUS;
+typedef _Return_type_success_(return == 0) DWORD DNS_STATUS;
 #define DNS_TYPE_ZERO       0x0000
 
 #define DNS_TYPE_A          0x0001
@@ -501,34 +501,186 @@ typedef struct _DnsRRSet {
     _prrset->pLastRR->pNext = NULL;  \
 }
 
-DNS_STATUS WINAPI DnsAcquireContextHandle_A(DWORD,PVOID,HANDLE*);
+DNS_STATUS
-DNS_STATUS WINAPI DnsAcquireContextHandle_W(DWORD,PVOID,HANDLE*);
+WINAPI
-DNS_STATUS WINAPI DnsExtractRecordsFromMessage_W(PDNS_MESSAGE_BUFFER,WORD,PDNS_RECORD*);
+DnsAcquireContextHandle_A(
-DNS_STATUS WINAPI DnsExtractRecordsFromMessage_UTF8(PDNS_MESSAGE_BUFFER,WORD,PDNS_RECORD*);
+  _In_ DWORD CredentialFlags,
-DNS_STATUS WINAPI DnsModifyRecordsInSet_A(PDNS_RECORD,PDNS_RECORD,DWORD,HANDLE,PIP4_ARRAY,PVOID);
+  _In_opt_ PVOID Credentials,
-DNS_STATUS WINAPI DnsModifyRecordsInSet_W(PDNS_RECORD,PDNS_RECORD,DWORD,HANDLE,PIP4_ARRAY,PVOID);
+  _Outptr_ PHANDLE pContext);
-DNS_STATUS WINAPI DnsModifyRecordsInSet_UTF8(PDNS_RECORD,PDNS_RECORD,DWORD,HANDLE,PIP4_ARRAY,PVOID);
+
-BOOL WINAPI DnsNameCompare_A(PCSTR,PCSTR);
+DNS_STATUS
-BOOL WINAPI DnsNameCompare_W(PCWSTR,PCWSTR);
+WINAPI
-DNS_STATUS WINAPI DnsQuery_A(PCSTR,WORD,DWORD,PIP4_ARRAY,PDNS_RECORD*,PVOID*);
+DnsAcquireContextHandle_W(
-DNS_STATUS WINAPI DnsQuery_W(PCWSTR,WORD,DWORD,PIP4_ARRAY,PDNS_RECORD*,PVOID*);
+  _In_ DWORD CredentialFlags,
-DNS_STATUS WINAPI DnsQuery_UTF8(PCSTR,WORD,DWORD,PIP4_ARRAY,PDNS_RECORD*,PVOID*);
+  _In_opt_ PVOID Credentials,
-DNS_STATUS WINAPI DnsQueryConfig(DNS_CONFIG_TYPE,DWORD,PWSTR,PVOID,PVOID,PDWORD);
+  _Outptr_ PHANDLE pContext);
-BOOL WINAPI DnsRecordCompare(PDNS_RECORD,PDNS_RECORD);
+
-PDNS_RECORD WINAPI DnsRecordCopyEx(PDNS_RECORD,DNS_CHARSET,DNS_CHARSET);
+DNS_STATUS
-void WINAPI DnsRecordListFree(PDNS_RECORD,DNS_FREE_TYPE);
+WINAPI
-BOOL WINAPI DnsRecordSetCompare(PDNS_RECORD,PDNS_RECORD,PDNS_RECORD*,PDNS_RECORD*);
+DnsExtractRecordsFromMessage_W(
-PDNS_RECORD WINAPI DnsRecordSetCopyEx(PDNS_RECORD,DNS_CHARSET,DNS_CHARSET);
+  _In_ PDNS_MESSAGE_BUFFER pDnsBuffer,
-PDNS_RECORD WINAPI DnsRecordSetDetach(PDNS_RECORD);
+  _In_ WORD wMessageLength,
-void WINAPI DnsReleaseContextHandle(HANDLE);
+  _Outptr_ PDNS_RECORD *ppRecord);
-DNS_STATUS WINAPI DnsReplaceRecordSetA(PDNS_RECORD,DWORD,HANDLE,PIP4_ARRAY,PVOID);
+
-DNS_STATUS WINAPI DnsReplaceRecordSetW(PDNS_RECORD,DWORD,HANDLE,PIP4_ARRAY,PVOID);
+DNS_STATUS
-DNS_STATUS WINAPI DnsReplaceRecordSetUTF8(PDNS_RECORD,DWORD,HANDLE,PIP4_ARRAY,PVOID);
+WINAPI
-DNS_STATUS WINAPI DnsValidateName_A(LPCSTR,DNS_NAME_FORMAT);
+DnsExtractRecordsFromMessage_UTF8(
-DNS_STATUS WINAPI DnsValidateName_W(LPCWSTR, DNS_NAME_FORMAT);
+  _In_ PDNS_MESSAGE_BUFFER pDnsBuffer,
-DNS_STATUS WINAPI DnsValidateName_UTF8(LPCSTR,DNS_NAME_FORMAT);
+  _In_ WORD wMessageLength,
-BOOL WINAPI DnsWriteQuestionToBuffer_W(PDNS_MESSAGE_BUFFER,LPDWORD,LPWSTR,WORD,WORD,BOOL);
+  _Outptr_ PDNS_RECORD *ppRecord);
-BOOL WINAPI DnsWriteQuestionToBuffer_UTF8(PDNS_MESSAGE_BUFFER,LPDWORD,LPSTR,WORD,WORD,BOOL);
+
+DNS_STATUS
+WINAPI
+DnsModifyRecordsInSet_A(
+  _In_opt_ PDNS_RECORD pAddRecords,
+  _In_opt_ PDNS_RECORD pDeleteRecords,
+  _In_ DWORD Options,
+  _In_opt_ HANDLE hCredentials,
+  _Inout_opt_ PIP4_ARRAY pExtraList,
+  _Inout_opt_ PVOID pReserved);
+
+DNS_STATUS
+WINAPI
+DnsModifyRecordsInSet_W(
+  _In_opt_ PDNS_RECORD pAddRecords,
+  _In_opt_ PDNS_RECORD pDeleteRecords,
+  _In_ DWORD Options,
+  _In_opt_ HANDLE hCredentials,
+  _Inout_opt_ PIP4_ARRAY pExtraList,
+  _Inout_opt_ PVOID pReserved);
+
+DNS_STATUS
+WINAPI
+DnsModifyRecordsInSet_UTF8(
+  _In_opt_ PDNS_RECORD pAddRecords,
+  _In_opt_ PDNS_RECORD pDeleteRecords,
+  _In_ DWORD Options,
+  _In_opt_ HANDLE hCredentials,
+  _Inout_opt_ PIP4_ARRAY pExtraList,
+  _Inout_opt_ PVOID pReserved);
+
+BOOL WINAPI DnsNameCompare_A(_In_ PCSTR, _In_ PCSTR);
+BOOL WINAPI DnsNameCompare_W(_In_ PCWSTR, _In_ PCWSTR);
+
+DNS_STATUS
+WINAPI
+DnsQuery_A(
+  _In_ PCSTR pszName,
+  _In_ WORD wType,
+  _In_ DWORD Options,
+  _Inout_opt_ PIP4_ARRAY pExtra,
+  _Outptr_result_maybenull_ PDNS_RECORD *ppQueryResults,
+  _Outptr_opt_result_maybenull_ PVOID *pReserved);
+
+DNS_STATUS
+WINAPI
+DnsQuery_W(
+  _In_ PCWSTR pszName,
+  _In_ WORD wType,
+  _In_ DWORD Options,
+  _Inout_opt_ PIP4_ARRAY pExtra,
+  _Outptr_result_maybenull_ PDNS_RECORD *ppQueryResults,
+  _Outptr_opt_result_maybenull_ PVOID *pReserved);
+
+DNS_STATUS
+WINAPI
+DnsQuery_UTF8(
+  _In_ PCSTR pszName,
+  _In_ WORD wType,
+  _In_ DWORD Options,
+  _Inout_opt_ PIP4_ARRAY pExtra,
+  _Outptr_result_maybenull_ PDNS_RECORD *ppQueryResults,
+  _Outptr_opt_result_maybenull_ PVOID *pReserved);
+
+DNS_STATUS
+WINAPI
+DnsQueryConfig(
+  _In_ DNS_CONFIG_TYPE Config,
+  _In_ DWORD Flag,
+  _In_opt_ PWSTR pwsAdapterName,
+  _In_opt_ PVOID pReserved,
+  _Out_writes_bytes_to_opt_(*pBufLen, *pBufLen) PVOID pBuffer,
+  _Inout_ PDWORD pBufLen);
+
+BOOL WINAPI DnsRecordCompare(_In_ PDNS_RECORD, _In_ PDNS_RECORD);
+
+PDNS_RECORD
+WINAPI
+DnsRecordCopyEx(
+  _In_ PDNS_RECORD pRecord,
+  _In_ DNS_CHARSET CharSetIn,
+  _In_ DNS_CHARSET CharSetOut);
+
+void WINAPI DnsRecordListFree(_Inout_opt_ PDNS_RECORD, _In_ DNS_FREE_TYPE);
+
+BOOL
+WINAPI
+DnsRecordSetCompare(
+  _Inout_ PDNS_RECORD pRR1,
+  _Inout_ PDNS_RECORD pRR2,
+  _Outptr_opt_result_maybenull_ PDNS_RECORD *ppDiff1,
+  _Outptr_opt_result_maybenull_ PDNS_RECORD *ppDiff2);
+
+PDNS_RECORD
+WINAPI
+DnsRecordSetCopyEx(
+  _In_ PDNS_RECORD pRecordSet,
+  _In_ DNS_CHARSET CharSetIn,
+  _In_ DNS_CHARSET CharSetOut);
+
+PDNS_RECORD WINAPI DnsRecordSetDetach(_Inout_ PDNS_RECORD);
+void WINAPI DnsReleaseContextHandle(_In_ HANDLE);
+
+DNS_STATUS
+WINAPI
+DnsReplaceRecordSetA(
+  _In_ PDNS_RECORD pReplaceSet,
+  _In_ DWORD Options,
+  _In_opt_ HANDLE hContext,
+  _Inout_opt_ PIP4_ARRAY pExtraInfo,
+  _Inout_opt_ PVOID pReserved);
+
+DNS_STATUS
+WINAPI
+DnsReplaceRecordSetW(
+  _In_ PDNS_RECORD pReplaceSet,
+  _In_ DWORD Options,
+  _In_opt_ HANDLE hContext,
+  _Inout_opt_ PIP4_ARRAY pExtraInfo,
+  _Inout_opt_ PVOID pReserved);
+
+DNS_STATUS
+WINAPI
+DnsReplaceRecordSetUTF8(
+  _In_ PDNS_RECORD pReplaceSet,
+  _In_ DWORD Options,
+  _In_opt_ HANDLE hContext,
+  _Inout_opt_ PIP4_ARRAY pExtraInfo,
+  _Inout_opt_ PVOID pReserved);
+
+DNS_STATUS WINAPI 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
+DnsWriteQuestionToBuffer_W(
+  _Inout_ PDNS_MESSAGE_BUFFER pDnsBuffer,
+  _Inout_ PDWORD pdwBufferSize,
+  _In_ LPWSTR pszName,
+  _In_ WORD wType,
+  _In_ WORD Xid,
+  _In_ BOOL fRecursionDesired);
+
+BOOL
+WINAPI
+DnsWriteQuestionToBuffer_UTF8(
+  _Inout_ PDNS_MESSAGE_BUFFER pDnsBuffer,
+  _Inout_ PDWORD pdwBufferSize,
+  _In_ LPSTR pszName,
+  _In_ WORD wType,
+  _In_ WORD Xid,
+  _In_ BOOL fRecursionDesired);
 
 #ifdef UNICODE
 #define DNS_MINFO_DATA DNS_MINFO_DATAW