Win32 API 日本語リファレンス
ホームUI.Accessibility › GetStateTextA

GetStateTextA

関数
アクセシビリティの状態ビットの説明文字列(ANSI)を取得する。
DLLOLEACC.dll文字セットANSI (-A)呼出規約winapiSetLastErrorあり対応OSWindows 2000 以降

シグネチャ

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

DWORD GetStateTextA(
    DWORD lStateBit,
    LPSTR lpszState,   // optional
    DWORD cchState
);

パラメーター

名前方向
lStateBitDWORDin
lpszStateLPSTRoutoptional
cchStateDWORDin

戻り値の型: DWORD

各言語での呼び出し定義

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

DWORD GetStateTextA(
    DWORD lStateBit,
    LPSTR lpszState,   // optional
    DWORD cchState
);
[DllImport("OLEACC.dll", CharSet = CharSet.Ansi, SetLastError = true, ExactSpelling = true)]
static extern uint GetStateTextA(
    uint lStateBit,   // DWORD
    [MarshalAs(UnmanagedType.LPStr)] System.Text.StringBuilder lpszState,   // LPSTR optional, out
    uint cchState   // DWORD
);
<DllImport("OLEACC.dll", CharSet:=CharSet.Ansi, SetLastError:=True, ExactSpelling:=True)>
Public Shared Function GetStateTextA(
    lStateBit As UInteger,   ' DWORD
    <MarshalAs(UnmanagedType.LPStr)> lpszState As System.Text.StringBuilder,   ' LPSTR optional, out
    cchState As UInteger   ' DWORD
) As UInteger
End Function
' lStateBit : DWORD
' lpszState : LPSTR optional, out
' cchState : DWORD
Declare PtrSafe Function GetStateTextA Lib "oleacc" ( _
    ByVal lStateBit As Long, _
    ByVal lpszState As String, _
    ByVal cchState As Long) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。
import ctypes
from ctypes import wintypes

GetStateTextA = ctypes.windll.oleacc.GetStateTextA
GetStateTextA.restype = wintypes.DWORD
GetStateTextA.argtypes = [
    wintypes.DWORD,  # lStateBit : DWORD
    wintypes.LPSTR,  # lpszState : LPSTR optional, out
    wintypes.DWORD,  # cchState : DWORD
]
# GetLastError: use ctypes.GetLastError() (or ctypes.WinDLL(use_last_error=True))
require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('OLEACC.dll')
GetStateTextA = Fiddle::Function.new(
  lib['GetStateTextA'],
  [
    -Fiddle::TYPE_INT,  # lStateBit : DWORD
    Fiddle::TYPE_VOIDP,  # lpszState : LPSTR optional, out
    -Fiddle::TYPE_INT,  # cchState : DWORD
  ],
  -Fiddle::TYPE_INT)
#[link(name = "oleacc")]
extern "system" {
    fn GetStateTextA(
        lStateBit: u32,  // DWORD
        lpszState: *mut u8,  // LPSTR optional, out
        cchState: u32  // DWORD
    ) -> u32;
}
// crates: windows-sys provides ready-made bindings for this API.
$sig = @"
[DllImport("OLEACC.dll", CharSet = CharSet.Ansi, SetLastError = true)]
public static extern uint GetStateTextA(uint lStateBit, [MarshalAs(UnmanagedType.LPStr)] System.Text.StringBuilder lpszState, uint cchState);
"@
$api = Add-Type -MemberDefinition $sig -Name 'OLEACC_GetStateTextA' -Namespace Win32 -PassThru
# $api::GetStateTextA(lStateBit, lpszState, cchState)
#uselib "OLEACC.dll"
#func global GetStateTextA "GetStateTextA" sptr, sptr, sptr
; GetStateTextA lStateBit, varptr(lpszState), cchState   ; 戻り値は stat
; lStateBit : DWORD -> "sptr"
; lpszState : LPSTR optional, out -> "sptr"
; cchState : DWORD -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。
出力引数:
#uselib "OLEACC.dll"
#cfunc global GetStateTextA "GetStateTextA" int, var, int
; res = GetStateTextA(lStateBit, lpszState, cchState)
; lStateBit : DWORD -> "int"
; lpszState : LPSTR optional, out -> "var"
; cchState : DWORD -> "int"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。
出力引数:
; DWORD GetStateTextA(DWORD lStateBit, LPSTR lpszState, DWORD cchState)
#uselib "OLEACC.dll"
#cfunc global GetStateTextA "GetStateTextA" int, var, int
; res = GetStateTextA(lStateBit, lpszState, cchState)
; lStateBit : DWORD -> "int"
; lpszState : LPSTR optional, out -> "var"
; cchState : DWORD -> "int"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。
import (
	"golang.org/x/sys/windows"
	"unsafe"
)

var (
	oleacc = windows.NewLazySystemDLL("OLEACC.dll")
	procGetStateTextA = oleacc.NewProc("GetStateTextA")
)

// lStateBit (DWORD), lpszState (LPSTR optional, out), cchState (DWORD)
r1, _, err := procGetStateTextA.Call(
	uintptr(lStateBit),
	uintptr(lpszState),
	uintptr(cchState),
)
_ = err  // syscall.Errno (valid when the call sets last-error)
_ = r1   // DWORD
function GetStateTextA(
  lStateBit: DWORD;   // DWORD
  lpszState: PAnsiChar;   // LPSTR optional, out
  cchState: DWORD   // DWORD
): DWORD; stdcall;
  external 'OLEACC.dll' name 'GetStateTextA';
result := DllCall("OLEACC\GetStateTextA"
    , "UInt", lStateBit   ; DWORD
    , "Ptr", lpszState   ; LPSTR optional, out
    , "UInt", cchState   ; DWORD
    , "UInt")   ; return: DWORD
●GetStateTextA(lStateBit, lpszState, cchState) = DLL("OLEACC.dll", "dword GetStateTextA(dword, char*, dword)")
# 呼び出し: GetStateTextA(lStateBit, lpszState, cchState)
# lStateBit : DWORD -> "dword"
# lpszState : LPSTR optional, out -> "char*"
# cchState : DWORD -> "dword"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。