org.postgresql.sspi.NTDSAPI Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of postgresql Show documentation

PostgreSQL JDBC Driver JDBC4

There is a newer version: 42.7.5

/*
 * Copyright (c) 2003, PostgreSQL Global Development Group
 * See the LICENSE file in the project root for more information.
 */
// Copyright (c) 2004, Open Cloud Limited.

package org.postgresql.sspi;

import com.sun.jna.LastErrorException;
import com.sun.jna.Native;
import com.sun.jna.WString;
import com.sun.jna.ptr.IntByReference;
import com.sun.jna.win32.StdCallLibrary;
import org.checkerframework.checker.nullness.qual.Nullable;

interface NTDSAPI extends StdCallLibrary {

  NTDSAPI instance = (NTDSAPI) Native.loadLibrary("NTDSAPI", NTDSAPI.class);

  /**
   * Wrap DsMakeSpn
   *
   * To get the String result, call
   *
   * 
   * new String(buf, 0, spnLength)
   * 
   *
   * on the byte[] buffer passed to 'spn' after testing to ensure ERROR_SUCCESS.
   *
   * @param serviceClass SPN service class (in)
   * @param serviceName SPN service name (in)
   * @param instanceName SPN instance name (in, null ok)
   * @param instancePort SPN port number (in, 0 to omit)
   * @param referrer SPN referer (in, null ok)
   * @param spnLength Size of 'spn' buffer (in), actual length of spn created including null
   *        terminator (out)
   * @param spn SPN buffer (in/out)
   * @return Error code ERROR_SUCCESS, ERROR_BUFFER_OVERFLOW or ERROR_INVALID_PARAMETER
   * @see 
   *     https://msdn.microsoft.com/en-us/library/ms676007(v=vs.85).aspx
   */
  int DsMakeSpnW(WString serviceClass, /* in */
      WString serviceName, /* in */
      @Nullable WString instanceName, /* in, optional, may be null */
      short instancePort, /* in */
      @Nullable WString referrer, /* in, optional, may be null */
      IntByReference spnLength, /* in: length of buffer spn; out: chars written */
      char[] spn /* out string */
  ) throws LastErrorException;

  int ERROR_SUCCESS = 0;
  int ERROR_INVALID_PARAMETER = 87;
  int ERROR_BUFFER_OVERFLOW = 111;
}