api: unify Win32 error type

This makes the code more readable and works around the clang-format.exe
issues with _Return_type_success_ source annotation.

Signed-off-by: Simon Rozman <simon@rozman.si>

api/api.h

@@ -7,6 +7,7 @@
 
 #include <Windows.h>
 
+typedef _Return_type_success_(return == ERROR_SUCCESS) DWORD WINSTATUS;
 extern HINSTANCE ResourceModule;
 
 _Check_return_
@@ -22,10 +23,9 @@ NamespaceInit();
 void
 NamespaceCleanup();
 
-_Return_type_success_(return ==
+extern WINSTATUS(WINAPI *NciSetConnectionName)(_In_ LPCGUID Guid, _In_z_ LPCWSTR NewName);
-                             0) extern DWORD(WINAPI *NciSetConnectionName)(_In_ LPCGUID Guid, _In_z_ LPCWSTR NewName);
 
-_Return_type_success_(return == 0) extern DWORD(WINAPI *NciGetConnectionName)(
+extern WINSTATUS(WINAPI *NciGetConnectionName)(
     _In_ LPCGUID Guid,
     _Out_z_bytecap_(InDestNameBytes) LPWSTR Name,
     _In_ DWORD InDestNameBytes,
@@ -52,5 +52,5 @@ typedef struct _WINTUN_ADAPTER
 VOID WINAPI
 WintunFreeAdapter(_In_ WINTUN_ADAPTER *Adapter);
 
-_Return_type_success_(return == 0) DWORD WINAPI
+WINSTATUS WINAPI
 WintunGetAdapter(_In_z_count_c_(MAX_POOL) LPCWSTR Pool, _In_z_ LPCWSTR IfName, _Out_ WINTUN_ADAPTER **Adapter);

api/devmgmt.c

@@ -31,7 +31,8 @@ const static GUID ADAPTER_NET_GUID = { 0xcac88484L,
  *
  * @return ERROR_SUCCESS on success; Win32 error code otherwise
  */
-static _Return_type_success_(return == 0) DWORD GetRegString(_Inout_ LPWSTR *Buf, _In_ DWORD Len, _In_ DWORD ValueType)
+static WINSTATUS
+GetRegString(_Inout_ LPWSTR *Buf, _In_ DWORD Len, _In_ DWORD ValueType)
 {
     HANDLE Heap = GetProcessHeap();
 
@@ -94,7 +95,7 @@ static _Return_type_success_(return == 0) DWORD GetRegString(_Inout_ LPWSTR *Buf
  *
  * @return ERROR_SUCCESS on success; Win32 error code otherwise
  */
-static _Return_type_success_(return == 0) DWORD
+static WINSTATUS
 GetRegMultiString(_Inout_ LPWSTR *Buf, _In_ DWORD Len, _In_ DWORD ValueType)
 {
     HANDLE Heap = GetProcessHeap();
@@ -163,7 +164,7 @@ static _Return_type_success_(return == 0) DWORD
  *
  * @return ERROR_SUCCESS on success; Win32 error code otherwise
  */
-static _Return_type_success_(return == 0) DWORD
+static WINSTATUS
 RegQueryString(_In_ HKEY Key, _In_opt_z_ LPCWSTR Name, _Out_ LPWSTR *Value)
 {
     HANDLE Heap = GetProcessHeap();
@@ -213,7 +214,7 @@ static _Return_type_success_(return == 0) DWORD
  *
  * @return ERROR_SUCCESS on success; Win32 error code otherwise
  */
-static _Return_type_success_(return == 0) DWORD
+static WINSTATUS
 RegQueryDWORD(_In_ HKEY Key, _In_opt_z_ LPCWSTR Name, _Out_ DWORD *Value)
 {
     DWORD ValueType, Size = sizeof(DWORD);
@@ -249,7 +250,8 @@ static _Return_type_success_(return == 0) DWORD
  *
  * @return ERROR_SUCCESS on success; Win32 error code otherwise
  */
-static _Return_type_success_(return == 0) DWORD GetDeviceRegistryProperty(
+static WINSTATUS
+GetDeviceRegistryProperty(
     _In_ HDEVINFO DevInfo,
     _In_ SP_DEVINFO_DATA *DevInfoData,
     _In_ DWORD Property,
@@ -298,7 +300,8 @@ static _Return_type_success_(return == 0) DWORD GetDeviceRegistryProperty(
  *
  * @return ERROR_SUCCESS on success; Win32 error code otherwise
  */
-static _Return_type_success_(return == 0) DWORD GetDeviceRegistryString(
+static WINSTATUS
+GetDeviceRegistryString(
     _In_ HDEVINFO DevInfo,
     _In_ SP_DEVINFO_DATA *DevInfoData,
     _In_ DWORD Property,
@@ -338,7 +341,8 @@ static _Return_type_success_(return == 0) DWORD GetDeviceRegistryString(
  *
  * @return ERROR_SUCCESS on success; Win32 error code otherwise
  */
-static _Return_type_success_(return == 0) DWORD GetDeviceRegistryMultiString(
+static WINSTATUS
+GetDeviceRegistryMultiString(
     _In_ HDEVINFO DevInfo,
     _In_ SP_DEVINFO_DATA *DevInfoData,
     _In_ DWORD Property,
@@ -410,7 +414,7 @@ IsOurHardwareID(_In_z_ LPWSTR Hwids)
 /**
  * Returns pool-specific device type name.
  */
-static _Return_type_success_(return == 0) DWORD
+static WINSTATUS
 GetPoolDeviceTypeName(_In_z_count_c_(MAX_POOL) LPCWSTR Pool, _Out_ LPWSTR *Name)
 {
     HANDLE Heap = GetProcessHeap();
@@ -433,7 +437,8 @@ static _Return_type_success_(return == 0) DWORD
 /**
  * Checks if SPDRP_DEVICEDESC or SPDRP_FRIENDLYNAME match device type name.
  */
-static _Return_type_success_(return == 0) DWORD IsPoolMember(
+static WINSTATUS
+IsPoolMember(
     _In_z_count_c_(MAX_POOL) LPCWSTR Pool,
     _In_ HDEVINFO DevInfo,
     _In_ SP_DEVINFO_DATA *DevInfoData,
@@ -489,7 +494,8 @@ cleanupDeviceDesc:
  *
  * @return ERROR_SUCCESS on success; Win32 error code otherwise
  */
-static _Return_type_success_(return == 0) DWORD GetDriverInfoDetail(
+static WINSTATUS
+GetDriverInfoDetail(
     _In_ HDEVINFO DevInfo,
     _In_ SP_DEVINFO_DATA *DevInfoData,
     _In_ SP_DRVINFO_DATA_W *DriverData,
@@ -518,7 +524,7 @@ static _Return_type_success_(return == 0) DWORD GetDriverInfoDetail(
 /**
  * Check if the device is using Wintun driver.
  */
-static _Return_type_success_(return == 0) DWORD
+static WINSTATUS
 IsUsingOurDriver(_In_ HDEVINFO DevInfo, _In_ SP_DEVINFO_DATA *DevInfoData, _Out_ BOOL *IsOurDriver)
 {
     if (!SetupDiBuildDriverInfoList(DevInfo, DevInfoData, SPDIT_COMPATDRIVER))
@@ -565,7 +571,8 @@ static _Return_type_success_(return == 0) DWORD
  *
  * @return ERROR_SUCCESS on success; Win32 error code otherwise
  */
-static _Return_type_success_(return == 0) DWORD InitAdapterData(
+static WINSTATUS
+InitAdapterData(
     _In_ HDEVINFO DevInfo,
     _In_ SP_DEVINFO_DATA *DevInfoData,
     _In_z_count_c_(MAX_POOL) LPCWSTR Pool,
@@ -642,7 +649,7 @@ WintunFreeAdapter(_In_ WINTUN_ADAPTER *Adapter)
  * ERROR_FILE_NOT_FOUND if adapter with given name is not found;
  * ERROR_ALREADY_EXISTS if adapter is found but not a Wintun-class or not a member of the pool
  */
-_Return_type_success_(return == 0) DWORD WINAPI
+WINSTATUS WINAPI
 WintunGetAdapter(_In_z_count_c_(MAX_POOL) LPCWSTR Pool, _In_z_ LPCWSTR IfName, _Out_ WINTUN_ADAPTER **Adapter)
 {
     DWORD Result;

api/nci.c

@@ -7,10 +7,10 @@
 
 static HMODULE NciModule;
 
-_Return_type_success_(return == 0) DWORD (WINAPI *NciSetConnectionName)(_In_ LPCGUID Guid, _In_z_ LPCWSTR NewName);
+WINSTATUS(WINAPI *NciSetConnectionName)(_In_ LPCGUID Guid, _In_z_ LPCWSTR NewName);
 
-_Return_type_success_(return == 0) DWORD (WINAPI *NciGetConnectionName)(
+WINSTATUS(WINAPI *NciGetConnectionName)
-    _In_ LPCGUID Guid,
+(_In_ LPCGUID Guid,
  _Out_z_bytecap_(InDestNameBytes) LPWSTR Name,
  _In_ DWORD InDestNameBytes,
  _Out_opt_ DWORD *OutDestNameBytes);
@@ -22,7 +22,8 @@ NciInit()
     if (!NciModule)
         return;
     NciSetConnectionName = (DWORD(WINAPI *)(LPCGUID, LPCWSTR))GetProcAddress(NciModule, "NciSetConnectionName");
-    NciGetConnectionName = (DWORD (WINAPI *)(LPCGUID, LPWSTR, DWORD, DWORD *))GetProcAddress(NciModule, "NciGetConnectionName");
+    NciGetConnectionName =
+        (DWORD(WINAPI *)(LPCGUID, LPWSTR, DWORD, DWORD *))GetProcAddress(NciModule, "NciGetConnectionName");
 }
 
 void