ホーム › Networking.Ldap › ldap_search_init_pageA

ldap_search_init_pageA

関数

ページ単位のLDAP検索を初期化する(ANSI版)。

DLLWLDAP32.dll文字セットANSI (-A)呼出規約cdeclSetLastErrorあり対応OSWindows Vista 以降

シグネチャ

// WLDAP32.dll  (ANSI / -A)
#include <windows.h>

PLDAPSearch ldap_search_init_pageA(
    LDAP* ExternalHandle,
    LPCSTR DistinguishedName,
    DWORD ScopeOfSearch,
    LPCSTR SearchFilter,
    CHAR** AttributeList,
    DWORD AttributesOnly,
    LDAPControlA** ServerControls,
    LDAPControlA** ClientControls,
    DWORD PageTimeLimit,
    DWORD TotalSizeLimit,
    LDAPSortKeyA** SortKeys
);

パラメーター

名前	型	方向
ExternalHandle	LDAP*	inout
DistinguishedName	LPCSTR	in
ScopeOfSearch	DWORD	in
SearchFilter	LPCSTR	in
AttributeList	CHAR**	in
AttributesOnly	DWORD	in
ServerControls	LDAPControlA**	inout
ClientControls	LDAPControlA**	inout
PageTimeLimit	DWORD	in
TotalSizeLimit	DWORD	in
SortKeys	LDAPSortKeyA**	inout

戻り値の型: PLDAPSearch

各言語での呼び出し定義

// WLDAP32.dll  (ANSI / -A)
#include <windows.h>

PLDAPSearch ldap_search_init_pageA(
    LDAP* ExternalHandle,
    LPCSTR DistinguishedName,
    DWORD ScopeOfSearch,
    LPCSTR SearchFilter,
    CHAR** AttributeList,
    DWORD AttributesOnly,
    LDAPControlA** ServerControls,
    LDAPControlA** ClientControls,
    DWORD PageTimeLimit,
    DWORD TotalSizeLimit,
    LDAPSortKeyA** SortKeys
);

[DllImport("WLDAP32.dll", CharSet = CharSet.Ansi, SetLastError = true, ExactSpelling = true, CallingConvention = CallingConvention.Cdecl)]
static extern IntPtr ldap_search_init_pageA(
    IntPtr ExternalHandle,   // LDAP* in/out
    [MarshalAs(UnmanagedType.LPStr)] string DistinguishedName,   // LPCSTR
    uint ScopeOfSearch,   // DWORD
    [MarshalAs(UnmanagedType.LPStr)] string SearchFilter,   // LPCSTR
    IntPtr AttributeList,   // CHAR**
    uint AttributesOnly,   // DWORD
    IntPtr ServerControls,   // LDAPControlA** in/out
    IntPtr ClientControls,   // LDAPControlA** in/out
    uint PageTimeLimit,   // DWORD
    uint TotalSizeLimit,   // DWORD
    IntPtr SortKeys   // LDAPSortKeyA** in/out
);

<DllImport("WLDAP32.dll", CharSet:=CharSet.Ansi, SetLastError:=True, ExactSpelling:=True, CallingConvention:=CallingConvention.Cdecl)>
Public Shared Function ldap_search_init_pageA(
    ExternalHandle As IntPtr,   ' LDAP* in/out
    <MarshalAs(UnmanagedType.LPStr)> DistinguishedName As String,   ' LPCSTR
    ScopeOfSearch As UInteger,   ' DWORD
    <MarshalAs(UnmanagedType.LPStr)> SearchFilter As String,   ' LPCSTR
    AttributeList As IntPtr,   ' CHAR**
    AttributesOnly As UInteger,   ' DWORD
    ServerControls As IntPtr,   ' LDAPControlA** in/out
    ClientControls As IntPtr,   ' LDAPControlA** in/out
    PageTimeLimit As UInteger,   ' DWORD
    TotalSizeLimit As UInteger,   ' DWORD
    SortKeys As IntPtr   ' LDAPSortKeyA** in/out
) As IntPtr
End Function

' ExternalHandle : LDAP* in/out
' DistinguishedName : LPCSTR
' ScopeOfSearch : DWORD
' SearchFilter : LPCSTR
' AttributeList : CHAR**
' AttributesOnly : DWORD
' ServerControls : LDAPControlA** in/out
' ClientControls : LDAPControlA** in/out
' PageTimeLimit : DWORD
' TotalSizeLimit : DWORD
' SortKeys : LDAPSortKeyA** in/out
Declare PtrSafe Function ldap_search_init_pageA Lib "wldap32" ( _
    ByVal ExternalHandle As LongPtr, _
    ByVal DistinguishedName As String, _
    ByVal ScopeOfSearch As Long, _
    ByVal SearchFilter As String, _
    ByVal AttributeList As LongPtr, _
    ByVal AttributesOnly As Long, _
    ByVal ServerControls As LongPtr, _
    ByVal ClientControls As LongPtr, _
    ByVal PageTimeLimit As Long, _
    ByVal TotalSizeLimit As Long, _
    ByVal SortKeys As LongPtr) As LongPtr
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。

import ctypes
from ctypes import wintypes

ldap_search_init_pageA = ctypes.cdll.wldap32.ldap_search_init_pageA
ldap_search_init_pageA.restype = ctypes.c_ssize_t
ldap_search_init_pageA.argtypes = [
    ctypes.c_void_p,  # ExternalHandle : LDAP* in/out
    wintypes.LPCSTR,  # DistinguishedName : LPCSTR
    wintypes.DWORD,  # ScopeOfSearch : DWORD
    wintypes.LPCSTR,  # SearchFilter : LPCSTR
    ctypes.c_void_p,  # AttributeList : CHAR**
    wintypes.DWORD,  # AttributesOnly : DWORD
    ctypes.c_void_p,  # ServerControls : LDAPControlA** in/out
    ctypes.c_void_p,  # ClientControls : LDAPControlA** in/out
    wintypes.DWORD,  # PageTimeLimit : DWORD
    wintypes.DWORD,  # TotalSizeLimit : DWORD
    ctypes.c_void_p,  # SortKeys : LDAPSortKeyA** in/out
]
# GetLastError: use ctypes.GetLastError() (or ctypes.WinDLL(use_last_error=True))

require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('WLDAP32.dll')
ldap_search_init_pageA = Fiddle::Function.new(
  lib['ldap_search_init_pageA'],
  [
    Fiddle::TYPE_VOIDP,  # ExternalHandle : LDAP* in/out
    Fiddle::TYPE_VOIDP,  # DistinguishedName : LPCSTR
    -Fiddle::TYPE_INT,  # ScopeOfSearch : DWORD
    Fiddle::TYPE_VOIDP,  # SearchFilter : LPCSTR
    Fiddle::TYPE_VOIDP,  # AttributeList : CHAR**
    -Fiddle::TYPE_INT,  # AttributesOnly : DWORD
    Fiddle::TYPE_VOIDP,  # ServerControls : LDAPControlA** in/out
    Fiddle::TYPE_VOIDP,  # ClientControls : LDAPControlA** in/out
    -Fiddle::TYPE_INT,  # PageTimeLimit : DWORD
    -Fiddle::TYPE_INT,  # TotalSizeLimit : DWORD
    Fiddle::TYPE_VOIDP,  # SortKeys : LDAPSortKeyA** in/out
  ],
  Fiddle::TYPE_INTPTR_T, Fiddle::Function::CDECL)

#[link(name = "wldap32")]
extern "C" {
    fn ldap_search_init_pageA(
        ExternalHandle: *mut LDAP,  // LDAP* in/out
        DistinguishedName: *const u8,  // LPCSTR
        ScopeOfSearch: u32,  // DWORD
        SearchFilter: *const u8,  // LPCSTR
        AttributeList: *mut *mut i8,  // CHAR**
        AttributesOnly: u32,  // DWORD
        ServerControls: *mut *mut LDAPControlA,  // LDAPControlA** in/out
        ClientControls: *mut *mut LDAPControlA,  // LDAPControlA** in/out
        PageTimeLimit: u32,  // DWORD
        TotalSizeLimit: u32,  // DWORD
        SortKeys: *mut *mut LDAPSortKeyA  // LDAPSortKeyA** in/out
    ) -> isize;
}
// crates: windows-sys provides ready-made bindings for this API.

$sig = @"
[DllImport("WLDAP32.dll", CharSet = CharSet.Ansi, SetLastError = true, CallingConvention = CallingConvention.Cdecl)]
public static extern IntPtr ldap_search_init_pageA(IntPtr ExternalHandle, [MarshalAs(UnmanagedType.LPStr)] string DistinguishedName, uint ScopeOfSearch, [MarshalAs(UnmanagedType.LPStr)] string SearchFilter, IntPtr AttributeList, uint AttributesOnly, IntPtr ServerControls, IntPtr ClientControls, uint PageTimeLimit, uint TotalSizeLimit, IntPtr SortKeys);
"@
$api = Add-Type -MemberDefinition $sig -Name 'WLDAP32_ldap_search_init_pageA' -Namespace Win32 -PassThru
# $api::ldap_search_init_pageA(ExternalHandle, DistinguishedName, ScopeOfSearch, SearchFilter, AttributeList, AttributesOnly, ServerControls, ClientControls, PageTimeLimit, TotalSizeLimit, SortKeys)

#uselib "WLDAP32.dll"
#func global ldap_search_init_pageA "ldap_search_init_pageA" sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr
; ldap_search_init_pageA varptr(ExternalHandle), DistinguishedName, ScopeOfSearch, SearchFilter, varptr(AttributeList), AttributesOnly, varptr(ServerControls), varptr(ClientControls), PageTimeLimit, TotalSizeLimit, varptr(SortKeys)   ; 戻り値は stat
; ExternalHandle : LDAP* in/out -> "sptr"
; DistinguishedName : LPCSTR -> "sptr"
; ScopeOfSearch : DWORD -> "sptr"
; SearchFilter : LPCSTR -> "sptr"
; AttributeList : CHAR** -> "sptr"
; AttributesOnly : DWORD -> "sptr"
; ServerControls : LDAPControlA** in/out -> "sptr"
; ClientControls : LDAPControlA** in/out -> "sptr"
; PageTimeLimit : DWORD -> "sptr"
; TotalSizeLimit : DWORD -> "sptr"
; SortKeys : LDAPSortKeyA** in/out -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。

出力引数:

#uselib "WLDAP32.dll"
#cfunc global ldap_search_init_pageA "ldap_search_init_pageA" var, str, int, str, var, int, var, var, int, int, var
; res = ldap_search_init_pageA(ExternalHandle, DistinguishedName, ScopeOfSearch, SearchFilter, AttributeList, AttributesOnly, ServerControls, ClientControls, PageTimeLimit, TotalSizeLimit, SortKeys)
; ExternalHandle : LDAP* in/out -> "var"
; DistinguishedName : LPCSTR -> "str"
; ScopeOfSearch : DWORD -> "int"
; SearchFilter : LPCSTR -> "str"
; AttributeList : CHAR** -> "var"
; AttributesOnly : DWORD -> "int"
; ServerControls : LDAPControlA** in/out -> "var"
; ClientControls : LDAPControlA** in/out -> "var"
; PageTimeLimit : DWORD -> "int"
; TotalSizeLimit : DWORD -> "int"
; SortKeys : LDAPSortKeyA** in/out -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "WLDAP32.dll"
#cfunc global ldap_search_init_pageA "ldap_search_init_pageA" sptr, str, int, str, sptr, int, sptr, sptr, int, int, sptr
; res = ldap_search_init_pageA(varptr(ExternalHandle), DistinguishedName, ScopeOfSearch, SearchFilter, varptr(AttributeList), AttributesOnly, varptr(ServerControls), varptr(ClientControls), PageTimeLimit, TotalSizeLimit, varptr(SortKeys))
; ExternalHandle : LDAP* in/out -> "sptr"
; DistinguishedName : LPCSTR -> "str"
; ScopeOfSearch : DWORD -> "int"
; SearchFilter : LPCSTR -> "str"
; AttributeList : CHAR** -> "sptr"
; AttributesOnly : DWORD -> "int"
; ServerControls : LDAPControlA** in/out -> "sptr"
; ClientControls : LDAPControlA** in/out -> "sptr"
; PageTimeLimit : DWORD -> "int"
; TotalSizeLimit : DWORD -> "int"
; SortKeys : LDAPSortKeyA** in/out -> "sptr"
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。

出力引数:

; PLDAPSearch ldap_search_init_pageA(LDAP* ExternalHandle, LPCSTR DistinguishedName, DWORD ScopeOfSearch, LPCSTR SearchFilter, CHAR** AttributeList, DWORD AttributesOnly, LDAPControlA** ServerControls, LDAPControlA** ClientControls, DWORD PageTimeLimit, DWORD TotalSizeLimit, LDAPSortKeyA** SortKeys)
#uselib "WLDAP32.dll"
#cfunc global ldap_search_init_pageA "ldap_search_init_pageA" var, str, int, str, var, int, var, var, int, int, var
; res = ldap_search_init_pageA(ExternalHandle, DistinguishedName, ScopeOfSearch, SearchFilter, AttributeList, AttributesOnly, ServerControls, ClientControls, PageTimeLimit, TotalSizeLimit, SortKeys)
; ExternalHandle : LDAP* in/out -> "var"
; DistinguishedName : LPCSTR -> "str"
; ScopeOfSearch : DWORD -> "int"
; SearchFilter : LPCSTR -> "str"
; AttributeList : CHAR** -> "var"
; AttributesOnly : DWORD -> "int"
; ServerControls : LDAPControlA** in/out -> "var"
; ClientControls : LDAPControlA** in/out -> "var"
; PageTimeLimit : DWORD -> "int"
; TotalSizeLimit : DWORD -> "int"
; SortKeys : LDAPSortKeyA** in/out -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。; PLDAPSearch ldap_search_init_pageA(LDAP* ExternalHandle, LPCSTR DistinguishedName, DWORD ScopeOfSearch, LPCSTR SearchFilter, CHAR** AttributeList, DWORD AttributesOnly, LDAPControlA** ServerControls, LDAPControlA** ClientControls, DWORD PageTimeLimit, DWORD TotalSizeLimit, LDAPSortKeyA** SortKeys)
#uselib "WLDAP32.dll"
#cfunc global ldap_search_init_pageA "ldap_search_init_pageA" intptr, str, int, str, intptr, int, intptr, intptr, int, int, intptr
; res = ldap_search_init_pageA(varptr(ExternalHandle), DistinguishedName, ScopeOfSearch, SearchFilter, varptr(AttributeList), AttributesOnly, varptr(ServerControls), varptr(ClientControls), PageTimeLimit, TotalSizeLimit, varptr(SortKeys))
; ExternalHandle : LDAP* in/out -> "intptr"
; DistinguishedName : LPCSTR -> "str"
; ScopeOfSearch : DWORD -> "int"
; SearchFilter : LPCSTR -> "str"
; AttributeList : CHAR** -> "intptr"
; AttributesOnly : DWORD -> "int"
; ServerControls : LDAPControlA** in/out -> "intptr"
; ClientControls : LDAPControlA** in/out -> "intptr"
; PageTimeLimit : DWORD -> "int"
; TotalSizeLimit : DWORD -> "int"
; SortKeys : LDAPSortKeyA** in/out -> "intptr"
; ※出力/バッファ引数はポインタ方式(token=intptr / 呼び出しは varptr(変数))。

import (
	"golang.org/x/sys/windows"
	"unsafe"
)

var (
	wldap32 = windows.NewLazySystemDLL("WLDAP32.dll")
	procldap_search_init_pageA = wldap32.NewProc("ldap_search_init_pageA")
)

// ExternalHandle (LDAP* in/out), DistinguishedName (LPCSTR), ScopeOfSearch (DWORD), SearchFilter (LPCSTR), AttributeList (CHAR**), AttributesOnly (DWORD), ServerControls (LDAPControlA** in/out), ClientControls (LDAPControlA** in/out), PageTimeLimit (DWORD), TotalSizeLimit (DWORD), SortKeys (LDAPSortKeyA** in/out)
r1, _, err := procldap_search_init_pageA.Call(
	uintptr(ExternalHandle),
	uintptr(unsafe.Pointer(windows.BytePtrFromString(DistinguishedName))),
	uintptr(ScopeOfSearch),
	uintptr(unsafe.Pointer(windows.BytePtrFromString(SearchFilter))),
	uintptr(AttributeList),
	uintptr(AttributesOnly),
	uintptr(ServerControls),
	uintptr(ClientControls),
	uintptr(PageTimeLimit),
	uintptr(TotalSizeLimit),
	uintptr(SortKeys),
)
_ = err  // syscall.Errno (valid when the call sets last-error)
_ = r1   // PLDAPSearch

function ldap_search_init_pageA(
  ExternalHandle: Pointer;   // LDAP* in/out
  DistinguishedName: PAnsiChar;   // LPCSTR
  ScopeOfSearch: DWORD;   // DWORD
  SearchFilter: PAnsiChar;   // LPCSTR
  AttributeList: Pointer;   // CHAR**
  AttributesOnly: DWORD;   // DWORD
  ServerControls: Pointer;   // LDAPControlA** in/out
  ClientControls: Pointer;   // LDAPControlA** in/out
  PageTimeLimit: DWORD;   // DWORD
  TotalSizeLimit: DWORD;   // DWORD
  SortKeys: Pointer   // LDAPSortKeyA** in/out
): NativeInt; cdecl;
  external 'WLDAP32.dll' name 'ldap_search_init_pageA';

result := DllCall("WLDAP32\ldap_search_init_pageA"
    , "Ptr", ExternalHandle   ; LDAP* in/out
    , "AStr", DistinguishedName   ; LPCSTR
    , "UInt", ScopeOfSearch   ; DWORD
    , "AStr", SearchFilter   ; LPCSTR
    , "Ptr", AttributeList   ; CHAR**
    , "UInt", AttributesOnly   ; DWORD
    , "Ptr", ServerControls   ; LDAPControlA** in/out
    , "Ptr", ClientControls   ; LDAPControlA** in/out
    , "UInt", PageTimeLimit   ; DWORD
    , "UInt", TotalSizeLimit   ; DWORD
    , "Ptr", SortKeys   ; LDAPSortKeyA** in/out
    , "Cdecl Ptr")   ; return: PLDAPSearch

●ldap_search_init_pageA(ExternalHandle, DistinguishedName, ScopeOfSearch, SearchFilter, AttributeList, AttributesOnly, ServerControls, ClientControls, PageTimeLimit, TotalSizeLimit, SortKeys) = DLL("WLDAP32.dll", "int ldap_search_init_pageA(void*, char*, dword, char*, void*, dword, void*, void*, dword, dword, void*)")
# 呼び出し: ldap_search_init_pageA(ExternalHandle, DistinguishedName, ScopeOfSearch, SearchFilter, AttributeList, AttributesOnly, ServerControls, ClientControls, PageTimeLimit, TotalSizeLimit, SortKeys)
# ExternalHandle : LDAP* in/out -> "void*"
# DistinguishedName : LPCSTR -> "char*"
# ScopeOfSearch : DWORD -> "dword"
# SearchFilter : LPCSTR -> "char*"
# AttributeList : CHAR** -> "void*"
# AttributesOnly : DWORD -> "dword"
# ServerControls : LDAPControlA** in/out -> "void*"
# ClientControls : LDAPControlA** in/out -> "void*"
# PageTimeLimit : DWORD -> "dword"
# TotalSizeLimit : DWORD -> "dword"
# SortKeys : LDAPSortKeyA** in/out -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。
# ※cdecl関数。DLL()宣言はstdcall前提。cdeclは EXEC_PTR(`cdecl`,…) を使用。