Win32 API 日本語リファレンス
ホームNetworking.ActiveDirectory › ADSPROPERROR

ADSPROPERROR

構造体
サイズx64: 48 バイト / x86: 24 バイト

サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。

フィールド

フィールドサイズx64x86説明
hwndPageHWND8/4+0+0エラーを生成したプロパティ ページのウィンドウ ハンドルを格納します。
pszPageTitleLPWSTR8/4+8+4エラーを生成したプロパティ ページのタイトルを格納する、NULL で終わる Unicode 文字列へのポインターです。
pszObjPathLPWSTR8/4+16+8エラーが発生したディレクトリ オブジェクトの ADsPath を格納する、NULL で終わる Unicode 文字列へのポインターです。
pszObjClassLPWSTR8/4+24+12エラーが発生したディレクトリ オブジェクトのクラス名を格納する、NULL で終わる Unicode 文字列へのポインターです。
hrHRESULT4+32+16発生したエラーのコードを指定する HRESULT 値を格納します。hrS_OK と等しくない場合、pszError は無視されます。hrS_OK と等しい場合、pszError にはエラー メッセージが格納されます。
pszErrorLPWSTR8/4+40+20エラー ダイアログ ボックスに表示するエラー メッセージを格納する、NULL で終わる Unicode 文字列へのポインターです。hrS_OK と等しくない場合、このメンバーは無視されます。その場合、エラー ダイアログ ボックスには hr で指定されたエラーに対するシステム定義のメッセージが表示されます。

公式ドキュメント

ADSPROPERROR 構造体は、ADsPropSendErrorMessage 関数または WM_ADSPROP_NOTIFY_ERROR メッセージを使用して、通知オブジェクトにエラー データを渡すために使用されます。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

#include <windows.h>

// ADSPROPERROR  (x64 48 / x86 24 バイト)
typedef struct ADSPROPERROR {
    HWND hwndPage;
    LPWSTR pszPageTitle;
    LPWSTR pszObjPath;
    LPWSTR pszObjClass;
    HRESULT hr;
    LPWSTR pszError;
} ADSPROPERROR;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct ADSPROPERROR
{
    public IntPtr hwndPage;
    public IntPtr pszPageTitle;
    public IntPtr pszObjPath;
    public IntPtr pszObjClass;
    public int hr;
    public IntPtr pszError;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure ADSPROPERROR
    Public hwndPage As IntPtr
    Public pszPageTitle As IntPtr
    Public pszObjPath As IntPtr
    Public pszObjClass As IntPtr
    Public hr As Integer
    Public pszError As IntPtr
End Structure
import ctypes
from ctypes import wintypes

class ADSPROPERROR(ctypes.Structure):
    _fields_ = [
        ("hwndPage", ctypes.c_void_p),
        ("pszPageTitle", ctypes.c_void_p),
        ("pszObjPath", ctypes.c_void_p),
        ("pszObjClass", ctypes.c_void_p),
        ("hr", ctypes.c_int),
        ("pszError", ctypes.c_void_p),
    ]
#[repr(C)]
pub struct ADSPROPERROR {
    pub hwndPage: *mut core::ffi::c_void,
    pub pszPageTitle: *mut core::ffi::c_void,
    pub pszObjPath: *mut core::ffi::c_void,
    pub pszObjClass: *mut core::ffi::c_void,
    pub hr: i32,
    pub pszError: *mut core::ffi::c_void,
}
import "golang.org/x/sys/windows"

type ADSPROPERROR struct {
	hwndPage uintptr
	pszPageTitle uintptr
	pszObjPath uintptr
	pszObjClass uintptr
	hr int32
	pszError uintptr
}
type
  ADSPROPERROR = record
    hwndPage: Pointer;
    pszPageTitle: Pointer;
    pszObjPath: Pointer;
    pszObjClass: Pointer;
    hr: Integer;
    pszError: Pointer;
  end;
const ADSPROPERROR = extern struct {
    hwndPage: ?*anyopaque,
    pszPageTitle: ?*anyopaque,
    pszObjPath: ?*anyopaque,
    pszObjClass: ?*anyopaque,
    hr: i32,
    pszError: ?*anyopaque,
};
type
  ADSPROPERROR {.bycopy.} = object
    hwndPage: pointer
    pszPageTitle: pointer
    pszObjPath: pointer
    pszObjClass: pointer
    hr: int32
    pszError: pointer
struct ADSPROPERROR
{
    void* hwndPage;
    void* pszPageTitle;
    void* pszObjPath;
    void* pszObjClass;
    int hr;
    void* pszError;
}

HSP用 定義

HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; ADSPROPERROR サイズ: 24 バイト(x86)
dim st, 6    ; 4byte整数×6(構造体サイズ 24 / 4 切り上げ)
; hwndPage : HWND (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; pszPageTitle : LPWSTR (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; pszObjPath : LPWSTR (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; pszObjClass : LPWSTR (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; hr : HRESULT (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; pszError : LPWSTR (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; ADSPROPERROR サイズ: 48 バイト(x64)
dim st, 12    ; 4byte整数×12(構造体サイズ 48 / 4 切り上げ)
; hwndPage : HWND (+0, 8byte)  qpoke st,0,値 / qpeek(st,0)  ※IronHSPのみ。3.7/3.8は lpoke st,0,下位 : lpoke st,4,上位
; pszPageTitle : LPWSTR (+8, 8byte)  qpoke st,8,値 / qpeek(st,8)  ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; pszObjPath : LPWSTR (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; pszObjClass : LPWSTR (+24, 8byte)  qpoke st,24,値 / qpeek(st,24)  ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; hr : HRESULT (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; pszError : LPWSTR (+40, 8byte)  qpoke st,40,値 / qpeek(st,40)  ※IronHSPのみ。3.7/3.8は lpoke st,40,下位 : lpoke st,44,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global ADSPROPERROR
    #field intptr hwndPage
    #field intptr pszPageTitle
    #field intptr pszObjPath
    #field intptr pszObjClass
    #field int hr
    #field intptr pszError
#endstruct

stdim st, ADSPROPERROR        ; NSTRUCT 変数を確保
st->hr = 100
mes "hr=" + st->hr