Win32 API 日本語リファレンス
ホームGraphics.Printing › SetCPSUIUserData

SetCPSUIUserData

関数
共通UIダイアログにユーザーデータを関連付ける。
DLLCOMPSTUI.dll呼出規約winapi

シグネチャ

// COMPSTUI.dll
#include <windows.h>

BOOL SetCPSUIUserData(
    HWND hDlg,
    UINT_PTR CPSUIUserData
);

パラメーター

名前方向説明
hDlgHWNDin対象のCPSUIダイアログボックスのハンドル。
CPSUIUserDataUINT_PTRinダイアログに関連付けるユーザー定義データ値。

戻り値の型: BOOL

各言語での呼び出し定義

// COMPSTUI.dll
#include <windows.h>

BOOL SetCPSUIUserData(
    HWND hDlg,
    UINT_PTR CPSUIUserData
);
[return: MarshalAs(UnmanagedType.Bool)]
[DllImport("COMPSTUI.dll", ExactSpelling = true)]
static extern bool SetCPSUIUserData(
    IntPtr hDlg,   // HWND
    UIntPtr CPSUIUserData   // UINT_PTR
);
<DllImport("COMPSTUI.dll", ExactSpelling:=True)>
Public Shared Function SetCPSUIUserData(
    hDlg As IntPtr,   ' HWND
    CPSUIUserData As UIntPtr   ' UINT_PTR
) As <MarshalAs(UnmanagedType.Bool)> Boolean
End Function
' hDlg : HWND
' CPSUIUserData : UINT_PTR
Declare PtrSafe Function SetCPSUIUserData Lib "compstui" ( _
    ByVal hDlg As LongPtr, _
    ByVal CPSUIUserData As LongPtr) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。
import ctypes
from ctypes import wintypes

SetCPSUIUserData = ctypes.windll.compstui.SetCPSUIUserData
SetCPSUIUserData.restype = wintypes.BOOL
SetCPSUIUserData.argtypes = [
    wintypes.HANDLE,  # hDlg : HWND
    ctypes.c_size_t,  # CPSUIUserData : UINT_PTR
]
require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('COMPSTUI.dll')
SetCPSUIUserData = Fiddle::Function.new(
  lib['SetCPSUIUserData'],
  [
    Fiddle::TYPE_VOIDP,  # hDlg : HWND
    Fiddle::TYPE_UINTPTR_T,  # CPSUIUserData : UINT_PTR
  ],
  Fiddle::TYPE_INT)
#[link(name = "compstui")]
extern "system" {
    fn SetCPSUIUserData(
        hDlg: *mut core::ffi::c_void,  // HWND
        CPSUIUserData: usize  // UINT_PTR
    ) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.
$sig = @"
[return: MarshalAs(UnmanagedType.Bool)]
[DllImport("COMPSTUI.dll")]
public static extern bool SetCPSUIUserData(IntPtr hDlg, UIntPtr CPSUIUserData);
"@
$api = Add-Type -MemberDefinition $sig -Name 'COMPSTUI_SetCPSUIUserData' -Namespace Win32 -PassThru
# $api::SetCPSUIUserData(hDlg, CPSUIUserData)
#uselib "COMPSTUI.dll"
#func global SetCPSUIUserData "SetCPSUIUserData" sptr, sptr
; SetCPSUIUserData hDlg, CPSUIUserData   ; 戻り値は stat
; hDlg : HWND -> "sptr"
; CPSUIUserData : UINT_PTR -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。
#uselib "COMPSTUI.dll"
#cfunc global SetCPSUIUserData "SetCPSUIUserData" sptr, sptr
; res = SetCPSUIUserData(hDlg, CPSUIUserData)
; hDlg : HWND -> "sptr"
; CPSUIUserData : UINT_PTR -> "sptr"
; BOOL SetCPSUIUserData(HWND hDlg, UINT_PTR CPSUIUserData)
#uselib "COMPSTUI.dll"
#cfunc global SetCPSUIUserData "SetCPSUIUserData" intptr, intptr
; res = SetCPSUIUserData(hDlg, CPSUIUserData)
; hDlg : HWND -> "intptr"
; CPSUIUserData : UINT_PTR -> "intptr"
import (
	"golang.org/x/sys/windows"
	"unsafe"
)

var (
	compstui = windows.NewLazySystemDLL("COMPSTUI.dll")
	procSetCPSUIUserData = compstui.NewProc("SetCPSUIUserData")
)

// hDlg (HWND), CPSUIUserData (UINT_PTR)
r1, _, err := procSetCPSUIUserData.Call(
	uintptr(hDlg),
	uintptr(CPSUIUserData),
)
_ = err  // syscall.Errno (valid when the call sets last-error)
_ = r1   // BOOL
function SetCPSUIUserData(
  hDlg: THandle;   // HWND
  CPSUIUserData: NativeUInt   // UINT_PTR
): BOOL; stdcall;
  external 'COMPSTUI.dll' name 'SetCPSUIUserData';
result := DllCall("COMPSTUI\SetCPSUIUserData"
    , "Ptr", hDlg   ; HWND
    , "UPtr", CPSUIUserData   ; UINT_PTR
    , "Int")   ; return: BOOL
●SetCPSUIUserData(hDlg, CPSUIUserData) = DLL("COMPSTUI.dll", "bool SetCPSUIUserData(void*, int)")
# 呼び出し: SetCPSUIUserData(hDlg, CPSUIUserData)
# hDlg : HWND -> "void*"
# CPSUIUserData : UINT_PTR -> "int"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。
const std = @import("std");

extern "compstui" fn SetCPSUIUserData(
    hDlg: ?*anyopaque, // HWND
    CPSUIUserData: usize // UINT_PTR
) callconv(std.os.windows.WINAPI) i32;
proc SetCPSUIUserData(
    hDlg: pointer,  # HWND
    CPSUIUserData: uint  # UINT_PTR
): int32 {.importc: "SetCPSUIUserData", stdcall, dynlib: "COMPSTUI.dll".}
pragma(lib, "compstui");
extern(Windows)
int SetCPSUIUserData(
    void* hDlg,   // HWND
    size_t CPSUIUserData   // UINT_PTR
);
ccall((:SetCPSUIUserData, "COMPSTUI.dll"), stdcall, Int32,
      (Ptr{Cvoid}, Csize_t),
      hDlg, CPSUIUserData)
# hDlg : HWND -> Ptr{Cvoid}
# CPSUIUserData : UINT_PTR -> Csize_t
# stdcall は 32bit のみ意味を持つ(x64 では無視)。
local ffi = require("ffi")
ffi.cdef[[
int32_t SetCPSUIUserData(
    void* hDlg,
    uintptr_t CPSUIUserData);
]]
local compstui = ffi.load("compstui")
-- compstui.SetCPSUIUserData(hDlg, CPSUIUserData)
-- hDlg : HWND
-- CPSUIUserData : UINT_PTR
-- 構造体/GUIDへのポインタは cdef が通るよう void* で表記(実型は各引数コメント参照)。値渡し構造体・enum は対応する typedef を cdef に追加すること。
const koffi = require('koffi');
const lib = koffi.load('COMPSTUI.dll');
const SetCPSUIUserData = lib.func('__stdcall', 'SetCPSUIUserData', 'int32_t', ['void *', 'uintptr_t']);
// SetCPSUIUserData(hDlg, CPSUIUserData)
// hDlg : HWND -> 'void *'
// CPSUIUserData : UINT_PTR -> 'uintptr_t'
// 出力ポインタは koffi.out(...) で包む。構造体は koffi.struct で定義。
const lib = Deno.dlopen("COMPSTUI.dll", {
  SetCPSUIUserData: { parameters: ["pointer", "usize"], result: "i32" },
});
// lib.symbols.SetCPSUIUserData(hDlg, CPSUIUserData)
// hDlg : HWND -> "pointer"
// CPSUIUserData : UINT_PTR -> "usize"
// 文字列引数は "buffer"(NUL 終端のバイト列を Uint8Array で渡す)。
// 値渡し構造体は { struct: [ ...field types... ] } を使用。
<?php
$ffi = FFI::cdef(<<<C
int32_t SetCPSUIUserData(
    void* hDlg,
    size_t CPSUIUserData);
C, "COMPSTUI.dll");
// $ffi->SetCPSUIUserData(hDlg, CPSUIUserData);
// hDlg : HWND
// CPSUIUserData : UINT_PTR
// 構造体/GUIDへのポインタは cdef が通るよう void* で表記(実型は各引数コメント参照)。値渡し構造体・enum は対応する typedef を cdef に追加すること。
// WINAPI(stdcall): x64 では呼出規約が統一されるため問題なし。x86 では __stdcall 対応のラッパが必要な場合あり。
import com.sun.jna.*;
import com.sun.jna.ptr.*;
import com.sun.jna.win32.StdCallLibrary;
import com.sun.jna.win32.W32APIOptions;

public interface Compstui extends StdCallLibrary {
    Compstui INSTANCE = Native.load("compstui", Compstui.class);
    boolean SetCPSUIUserData(
        Pointer hDlg,   // HWND
        long CPSUIUserData   // UINT_PTR
    );
}
@[Link("compstui")]
lib LibCOMPSTUI
  fun SetCPSUIUserData = SetCPSUIUserData(
    hDlg : Void*,   # HWND
    CPSUIUserData : LibC::SizeT   # UINT_PTR
  ) : Int32
end
# 構造体/GUID/enum は lib 内に対応する型定義が必要。
# 呼出規約: x64 は規約統一のため OK。x86(32bit)は WINAPI=stdcall だが Crystal の fun に stdcall 付与構文がなく非対応。
import 'dart:ffi';
import 'package:ffi/ffi.dart';

typedef SetCPSUIUserDataNative = Int32 Function(Pointer<Void>, UintPtr);
typedef SetCPSUIUserDataDart = int Function(Pointer<Void>, int);
final SetCPSUIUserData = DynamicLibrary.open('COMPSTUI.dll')
    .lookupFunction<SetCPSUIUserDataNative, SetCPSUIUserDataDart>('SetCPSUIUserData');
// hDlg : HWND -> Pointer<Void>
// CPSUIUserData : UINT_PTR -> UintPtr
// 文字列は package:ffi の "...".toNativeUtf16()/toNativeUtf8() で変換。
{$mode objfpc}{$H+}
function SetCPSUIUserData(
  hDlg: THandle;   // HWND
  CPSUIUserData: NativeUInt   // UINT_PTR
): BOOL; stdcall;
  external 'COMPSTUI.dll' name 'SetCPSUIUserData';
import Foreign
import Foreign.C.Types
import Foreign.C.String

foreign import stdcall safe "SetCPSUIUserData"
  c_SetCPSUIUserData :: Ptr () -> CUIntPtr -> IO CInt
-- hDlg : HWND -> Ptr ()
-- CPSUIUserData : UINT_PTR -> CUIntPtr
-- 要 GHC(Windows)。stdcall は x64 では ccall として扱われる。ブロックする API は safe 呼び出し推奨。
open Ctypes
open Foreign

let setcpsuiuserdata =
  foreign "SetCPSUIUserData"
    ((ptr void) @-> size_t @-> returning int32_t)
(* hDlg : HWND -> (ptr void) *)
(* CPSUIUserData : UINT_PTR -> size_t *)
(* foreign は cdecl 前提。x64 Windows では WINAPI と一致。構造体は ctypes structure を定義のこと。 *)
(cffi:define-foreign-library compstui (t "COMPSTUI.dll"))
(cffi:use-foreign-library compstui)

(cffi:defcfun ("SetCPSUIUserData" set-cpsuiuser-data :convention :stdcall) :int32
  (h-dlg :pointer)   ; HWND
  (cpsuiuser-data :uint64))   ; UINT_PTR
; isize/usize(INT_PTR/SIZE_T)は x64 前提で :int64/:uint64。x86 では :int32/:uint32。
use Win32::API;
my $SetCPSUIUserData = Win32::API::More->new('COMPSTUI',
    'BOOL SetCPSUIUserData(HANDLE hDlg, WPARAM CPSUIUserData)');
# my $ret = $SetCPSUIUserData->Call($hDlg, $CPSUIUserData);
# hDlg : HWND -> HANDLE
# CPSUIUserData : UINT_PTR -> WPARAM
# 値渡し構造体は pack() した文字列、または Win32::API::Struct を使用。