如何在 vapi 文件中编写无效指针类型定义

Question

我正在尝试编写一个VAPI文件以使用unixODBC，其中一个函数称为SQLAllocHandle：

// From <sqltypes.h>
#define SQL_API
typedef signed short int SQLSMALLINT;
typedef SQLSMALLINT      SQLRETURN;
typedef void *           SQLHANDLE;
// From <sql.h>
#define SQL_SUCCESS                0
#define SQL_SUCCESS_WITH_INFO      1
#define SQL_ERROR                 (-1)
#define SQL_INVALID_HANDLE        (-2)
#define SQL_HANDLE_ENV             1
#define SQL_HANDLE_DBC             2
#define SQL_HANDLE_STMT            3
#define SQL_HANDLE_DESC            4
#define SQL_NULL_HANDLE            0
SQLRETURN SQL_API SQLAllocHandle(SQLSMALLINT HandleType, SQLHANDLE InputHandle, SQLHANDLE *OutputHandle);

这是我第一次尝试编写 vapi 文件，但目前文档很少（Vala vapi 文件文档）。

调用代码应如下所示：

using UnixOdbc;
int main(string[] args) {
  Handle h;
  if (AllocHandle (HandleType.ENV, NullHandle, out h) == Return.SUCCESS)
  ...
}

特别是我想知道如何转换实际上只是一个void *（不透明的空指针）的SQLHANDLE类型。

换句话说，UnixOdbc.Handle类型在 vapi 文件中会是什么样子？

我目前的方法是假装它是一个长：

[CCode (cheader_filename = "sql.h, sqltypes.h")]
namespace UnixOdbc {
    [CCode (cname = "SQLRETURN", cprefix = "SQL_")]
    public enum Return {
        SUCCESS,
        SUCCESS_WITH_INFO,
        ERROR,
        INVALID_HANDLE
    }
    [CCode (cname = "SQLSMALLINT", cprefix = "SQL_HANDLE_")]
    public enum HandleType {
        ENV,
        DBC,
        STMT,
        DESC
    }
    [CCode (cname = "SQLHANDLE")]
    public struct Handle: long {}
    [CCode (cname = "SQL_NULL_HANDLE")]
    public const Handle NULL_HANDLE;
    [CCode (cname = "SQLAllocHandle")]
    public static Return AllocHandle (HandleType handle_type, Handle input_handle, out Handle output_handle);
}

Answer 1

您可以尝试阅读旧版 VAPI 文件的指南。我会做：

[CCode(cname = "void")]
[Compact]
public class Handle {
   [CCode(cname = "SQLAllocHandle")]
   public static Return alocate_handle(HandleType type, Handle? input_handle, out Handle?  output_handle);
...
}

简单地忽略SQL_NULL_HANDLE的绑定;它不会做任何有用的事情。