OleUIConvertW
関数シグネチャ
// oledlg.dll (Unicode / -W)
#include <windows.h>
DWORD OleUIConvertW(
OLEUICONVERTW* param0
);パラメーター
| 名前 | 型 | 方向 | 説明 |
|---|---|---|---|
| param0 | OLEUICONVERTW* | in | オブジェクトの変換ダイアログを構成するOLEUICONVERTW構造体へのポインタ。 |
戻り値の型: DWORD
公式ドキュメント
標準の Convert ダイアログ ボックスを呼び出します。これにより、ユーザーは指定した単一のオブジェクトの種類を変更したり、指定したオブジェクトのクラスに属するすべての OLE オブジェクトの種類を変更したりできます。(Unicode)
戻り値
標準の成功 / エラー定義
| 戻り値 | 説明 |
|---|---|
| 不明な失敗です(未使用)。 | |
| ユーザーが OK ボタンを押しました。 | |
| エラーはありません。OLEUI_OK と同じです。 | |
| ユーザーが Cancel ボタンを押しました。 |
標準のフィールド検証エラー
| 戻り値 | 説明 |
|---|---|
| すべてのダイアログ ボックスに共通するエラーは、OLEUI_ERR_STANDARDMIN から OLEUI_ERR_STANDARDMAX の範囲にあります。この値により、アプリケーションは標準メッセージを判定し、ユーザーにエラー メッセージを表示できます。 | |
| 関数に渡された OLEUIXXX 構造体へのポインターが NULL でした。 | |
| OLEUIXXX 構造体への読み取りまたは書き込みアクセスに対する権限が不足しています。 | |
| cbstruct の値が正しくありません。 | |
| hWndOwner の値が無効です。 | |
| lpszCaption の値が無効です。 | |
| lpfnHook の値が無効です。 | |
| hInstance の値が無効です。 | |
| lpszTemplate の値が無効です。 | |
| hResource の値が無効です。 |
初期化エラー
| 戻り値 | 説明 |
|---|---|
| ダイアログ ボックスのテンプレートが見つかりませんでした。 | |
| ダイアログ ボックスのテンプレートを読み込めませんでした。 | |
| ダイアログ ボックスの初期化に失敗しました。 | |
| LocalAlloc または標準の IMalloc アロケーターの呼び出しに失敗しました。 | |
| GlobalAlloc または標準の IMalloc アロケーターの呼び出しに失敗しました。 | |
| ライブラリからローカライズされたリソースを取得するための LoadString を呼び出せませんでした。 | |
| 標準の IMalloc アロケーターの呼び出しに失敗しました。 |
関数固有のエラー
| 戻り値 | 説明 |
|---|---|
| すべてのダイアログ ボックスに共通するエラーは、OLEUI_ERR_STANDARDMIN から OLEUI_ERR_STANDARDMAX の範囲にあります。この値により、アプリケーションは標準メッセージを判定し、ユーザーにエラー メッセージを表示できます。 | |
| clsid の値が無効でした。 | |
| dvAspect の値が無効でした。このメンバーはオブジェクトのアスペクトを指定します。 | |
| wFormat の値が無効でした。このメンバーはオブジェクトのデータ形式を指定します。 | |
| 文字列値(たとえば lpszUserType や lpszDefLabel)が無効でした。 |
解説(Remarks)
OleUIConvert は、レジストリをたどって Readable キーおよび ReadWritable キーのエントリを探すことで、Convert ダイアログ ボックスのリスト ボックスにオブジェクト クラスを設定します。元のクラスの既定のファイル形式を Readable キーに含むすべてのクラスが Convert リストに追加され、元のクラスの既定のファイル形式を ReadWritable キーに含むすべてのクラスが Activate As リストに追加されます。Convert リストは Convert ラジオ ボタンが選択されているとき(既定の選択)にダイアログ ボックスのリスト ボックスに表示され、Activate As リストは Activate As が選択されているときに表示されます。
なお、指定したクラスに属するすべてのオブジェクトの種類を変更できるのは、CF_CONVERTONLY が指定されていない場合に限られます。
この関数を呼び出す convert コマンドは、OleUICanConvertOrActivateAs が S_OK を返す場合にのみユーザーが利用できるようにしてください。
oledlg.h ヘッダーは OLEUICONVERT をエイリアスとして定義しており、UNICODE プリプロセッサ定数の定義に基づいてこの関数の ANSI 版または Unicode 版を自動的に選択します。エンコーディング非依存のエイリアスの使用と、エンコーディング非依存ではないコードを混在させると、不一致が生じ、コンパイル エラーや実行時エラーの原因となることがあります。詳細については、Conventions for Function Prototypes を参照してください。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での呼び出し定義
// oledlg.dll (Unicode / -W)
#include <windows.h>
DWORD OleUIConvertW(
OLEUICONVERTW* param0
);[DllImport("oledlg.dll", CharSet = CharSet.Unicode, ExactSpelling = true)]
static extern uint OleUIConvertW(
IntPtr param0 // OLEUICONVERTW*
);<DllImport("oledlg.dll", CharSet:=CharSet.Unicode, ExactSpelling:=True)>
Public Shared Function OleUIConvertW(
param0 As IntPtr ' OLEUICONVERTW*
) As UInteger
End Function' param0 : OLEUICONVERTW*
Declare PtrSafe Function OleUIConvertW Lib "oledlg" ( _
ByVal param0 As LongPtr) As Long
' Unicode(W): 文字列は ByVal As LongPtr とし StrPtr(unicodeStr) を渡す
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。import ctypes
from ctypes import wintypes
OleUIConvertW = ctypes.windll.oledlg.OleUIConvertW
OleUIConvertW.restype = wintypes.DWORD
OleUIConvertW.argtypes = [
ctypes.c_void_p, # param0 : OLEUICONVERTW*
]require 'fiddle'
require 'fiddle/import'
lib = Fiddle.dlopen('oledlg.dll')
OleUIConvertW = Fiddle::Function.new(
lib['OleUIConvertW'],
[
Fiddle::TYPE_VOIDP, # param0 : OLEUICONVERTW*
],
-Fiddle::TYPE_INT)
# Wide strings: pass str.encode("UTF-16LE") + "\x00\x00"#[link(name = "oledlg")]
extern "system" {
fn OleUIConvertW(
param0: *mut OLEUICONVERTW // OLEUICONVERTW*
) -> u32;
}
// crates: windows-sys provides ready-made bindings for this API.$sig = @"
[DllImport("oledlg.dll", CharSet = CharSet.Unicode)]
public static extern uint OleUIConvertW(IntPtr param0);
"@
$api = Add-Type -MemberDefinition $sig -Name 'oledlg_OleUIConvertW' -Namespace Win32 -PassThru
# $api::OleUIConvertW(param0)#uselib "oledlg.dll"
#func global OleUIConvertW "OleUIConvertW" wptr
; OleUIConvertW varptr(param0) ; 戻り値は stat
; param0 : OLEUICONVERTW* -> "wptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。#uselib "oledlg.dll" #cfunc global OleUIConvertW "OleUIConvertW" var ; res = OleUIConvertW(param0) ; param0 : OLEUICONVERTW* -> "var" ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "oledlg.dll" #cfunc global OleUIConvertW "OleUIConvertW" sptr ; res = OleUIConvertW(varptr(param0)) ; param0 : OLEUICONVERTW* -> "sptr" ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; DWORD OleUIConvertW(OLEUICONVERTW* param0) #uselib "oledlg.dll" #cfunc global OleUIConvertW "OleUIConvertW" var ; res = OleUIConvertW(param0) ; param0 : OLEUICONVERTW* -> "var" ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。; DWORD OleUIConvertW(OLEUICONVERTW* param0) #uselib "oledlg.dll" #cfunc global OleUIConvertW "OleUIConvertW" intptr ; res = OleUIConvertW(varptr(param0)) ; param0 : OLEUICONVERTW* -> "intptr" ; ※出力/バッファ引数はポインタ方式(token=intptr / 呼び出しは varptr(変数))。
import (
"golang.org/x/sys/windows"
"unsafe"
)
var (
oledlg = windows.NewLazySystemDLL("oledlg.dll")
procOleUIConvertW = oledlg.NewProc("OleUIConvertW")
)
// param0 (OLEUICONVERTW*)
r1, _, err := procOleUIConvertW.Call(
uintptr(param0),
)
_ = err // syscall.Errno (valid when the call sets last-error)
_ = r1 // DWORDfunction OleUIConvertW(
param0: Pointer // OLEUICONVERTW*
): DWORD; stdcall;
external 'oledlg.dll' name 'OleUIConvertW';result := DllCall("oledlg\OleUIConvertW"
, "Ptr", param0 ; OLEUICONVERTW*
, "UInt") ; return: DWORD●OleUIConvertW(param0) = DLL("oledlg.dll", "dword OleUIConvertW(void*)")
# 呼び出し: OleUIConvertW(param0)
# param0 : OLEUICONVERTW* -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。
# ※-W(Unicode)関数。なでしこ1はANSIのため -A 版の利用を推奨。const std = @import("std");
extern "oledlg" fn OleUIConvertW(
param0: [*c]OLEUICONVERTW // OLEUICONVERTW*
) callconv(std.os.windows.WINAPI) u32;
// Unicode(-W): UTF-16LE のヌル終端バッファ([*c]const u16)を渡す。proc OleUIConvertW(
param0: ptr OLEUICONVERTW # OLEUICONVERTW*
): uint32 {.importc: "OleUIConvertW", stdcall, dynlib: "oledlg.dll".}
# Unicode(-W): WideCString は newWideCString("...") で生成。pragma(lib, "oledlg");
extern(Windows)
uint OleUIConvertW(
OLEUICONVERTW* param0 // OLEUICONVERTW*
);ccall((:OleUIConvertW, "oledlg.dll"), stdcall, UInt32,
(Ptr{OLEUICONVERTW},),
param0)
# param0 : OLEUICONVERTW* -> Ptr{OLEUICONVERTW}
# stdcall は 32bit のみ意味を持つ(x64 では無視)。
# Unicode(-W): Cwstring には transcode(UInt16, "...") 等で UTF-16 を渡す。local ffi = require("ffi")
ffi.cdef[[
uint32_t OleUIConvertW(
void* param0);
]]
local oledlg = ffi.load("oledlg")
-- oledlg.OleUIConvertW(param0)
-- param0 : OLEUICONVERTW*
-- 構造体/GUIDへのポインタは cdef が通るよう void* で表記(実型は各引数コメント参照)。値渡し構造体・enum は対応する typedef を cdef に追加すること。
-- Unicode(-W): uint16_t* には UTF-16LE のバッファ(ffi.new("uint16_t[?]", ...))を渡す。const koffi = require('koffi');
const lib = koffi.load('oledlg.dll');
const OleUIConvertW = lib.func('__stdcall', 'OleUIConvertW', 'uint32_t', ['void *']);
// OleUIConvertW(param0)
// param0 : OLEUICONVERTW* -> 'void *'
// 出力ポインタは koffi.out(...) で包む。構造体は koffi.struct で定義。const lib = Deno.dlopen("oledlg.dll", {
OleUIConvertW: { parameters: ["pointer"], result: "u32" },
});
// lib.symbols.OleUIConvertW(param0)
// param0 : OLEUICONVERTW* -> "pointer"
// 文字列は "buffer"。Unicode(-W) は new TextEncoder() ではなく UTF-16LE のバイト列(末尾に \x00\x00)を Uint8Array で渡す。
// 値渡し構造体は { struct: [ ...field types... ] } を使用。<?php
$ffi = FFI::cdef(<<<C
uint32_t OleUIConvertW(
void* param0);
C, "oledlg.dll");
// $ffi->OleUIConvertW(param0);
// param0 : OLEUICONVERTW*
// 構造体/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 Oledlg extends StdCallLibrary {
Oledlg INSTANCE = Native.load("oledlg", Oledlg.class, W32APIOptions.UNICODE_OPTIONS);
int OleUIConvertW(
Pointer param0 // OLEUICONVERTW*
);
}
// Unicode(-W): WString(入力)/char[](出力)で UTF-16 をマーシャリング。@[Link("oledlg")]
lib Liboledlg
fun OleUIConvertW = OleUIConvertW(
param0 : OLEUICONVERTW* # OLEUICONVERTW*
) : UInt32
end
# 構造体/GUID/enum は lib 内に対応する型定義が必要。
# 呼出規約: x64 は規約統一のため OK。x86(32bit)は WINAPI=stdcall だが Crystal の fun に stdcall 付与構文がなく非対応。import 'dart:ffi';
import 'package:ffi/ffi.dart';
typedef OleUIConvertWNative = Uint32 Function(Pointer<Void>);
typedef OleUIConvertWDart = int Function(Pointer<Void>);
final OleUIConvertW = DynamicLibrary.open('oledlg.dll')
.lookupFunction<OleUIConvertWNative, OleUIConvertWDart>('OleUIConvertW');
// param0 : OLEUICONVERTW* -> Pointer<Void>
// 文字列は package:ffi の "...".toNativeUtf16()/toNativeUtf8() で変換。{$mode objfpc}{$H+}
function OleUIConvertW(
param0: Pointer // OLEUICONVERTW*
): DWORD; stdcall;
external 'oledlg.dll' name 'OleUIConvertW';import Foreign
import Foreign.C.Types
import Foreign.C.String
foreign import stdcall safe "OleUIConvertW"
c_OleUIConvertW :: Ptr () -> IO Word32
-- param0 : OLEUICONVERTW* -> Ptr ()
-- 要 GHC(Windows)。stdcall は x64 では ccall として扱われる。ブロックする API は safe 呼び出し推奨。open Ctypes
open Foreign
let oleuiconvertw =
foreign "OleUIConvertW"
((ptr void) @-> returning uint32_t)
(* param0 : OLEUICONVERTW* -> (ptr void) *)
(* foreign は cdecl 前提。x64 Windows では WINAPI と一致。構造体は ctypes structure を定義のこと。 *)(cffi:define-foreign-library oledlg (t "oledlg.dll"))
(cffi:use-foreign-library oledlg)
(cffi:defcfun ("OleUIConvertW" ole-uiconvert-w :convention :stdcall) :uint32
(param0 :pointer)) ; OLEUICONVERTW*
; isize/usize(INT_PTR/SIZE_T)は x64 前提で :int64/:uint64。x86 では :int32/:uint32。use Win32::API;
my $OleUIConvertW = Win32::API::More->new('oledlg',
'DWORD OleUIConvertW(LPVOID param0)');
# my $ret = $OleUIConvertW->Call($param0);
# param0 : OLEUICONVERTW* -> LPVOID
# 値渡し構造体は pack() した文字列、または Win32::API::Struct を使用。
# Unicode(-W): LPCWSTR/LPWSTR は Win32::API が UTF-16 変換を行う。関連項目
- f OleUIConvertA (ANSI版) — オブジェクトのクラスを変換するダイアログを表示する。ANSI版。
- f OleUICanConvertOrActivateAs — 指定CLSIDが変換または別クラスでの活性化が可能か判定する。