Win32 API 日本語リファレンス
ホームDevices.DeviceAndDriverInstallation › CABINET_INFO_A

CABINET_INFO_A

構造体
サイズx64: 28 バイト / x86: 16 バイトパッキング1

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

フィールド

フィールドサイズx64x86説明
CabinetPathLPSTR8/4+0+0キャビネットファイルへのパスです。
CabinetFileLPSTR8/4+8+4キャビネットファイルの名前です。
DiskNameLPSTR8/4+16+8キャビネットファイルを格納しているソースメディアの名前です。
SetIdWORD2+24+12現在のセットの識別子です。この番号は、キャビネットを作成するソフトウェアによって生成されます。
CabinetNumberWORD2+26+14キャビネットの番号です。この番号はキャビネットを作成するソフトウェアによって生成され、通常はセット内でのキャビネットの位置の序数を示す 0 から始まる、または 1 から始まるインデックスです。

公式ドキュメント

CABINET_INFO 構造体は、キャビネットファイルに関する情報を格納します。 SetupIterateCabinet 関数は、キャビネットのコールバックルーチンに SPFILENOTIFY_NEEDNEWCABINET 通知を送信する際に、この構造体をパラメーターとして指定します。

解説(Remarks)

メモ

setupapi.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI 版または Unicode 版を自動的に選択するエイリアスとして CABINET_INFO を定義しています。エンコーディング中立のエイリアスを、エンコーディング中立でないコードと混在させて使用すると、不一致が生じてコンパイルエラーや実行時エラーの原因となる場合があります。詳細については、関数プロトタイプの規則を参照してください。

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

各言語での定義

#include <windows.h>

// CABINET_INFO_A  (x64 28 / x86 16 バイト)
#pragma pack(push, 1)
typedef struct CABINET_INFO_A {
    LPSTR CabinetPath;
    LPSTR CabinetFile;
    LPSTR DiskName;
    WORD SetId;
    WORD CabinetNumber;
} CABINET_INFO_A;
#pragma pack(pop)
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, Pack = 1, CharSet = CharSet.Unicode)]
public struct CABINET_INFO_A
{
    public IntPtr CabinetPath;
    public IntPtr CabinetFile;
    public IntPtr DiskName;
    public ushort SetId;
    public ushort CabinetNumber;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, Pack:=1, CharSet:=CharSet.Unicode)>
Public Structure CABINET_INFO_A
    Public CabinetPath As IntPtr
    Public CabinetFile As IntPtr
    Public DiskName As IntPtr
    Public SetId As UShort
    Public CabinetNumber As UShort
End Structure
import ctypes
from ctypes import wintypes

class CABINET_INFO_A(ctypes.Structure):
    _pack_ = 1
    _fields_ = [
        ("CabinetPath", ctypes.c_void_p),
        ("CabinetFile", ctypes.c_void_p),
        ("DiskName", ctypes.c_void_p),
        ("SetId", ctypes.c_ushort),
        ("CabinetNumber", ctypes.c_ushort),
    ]
#[repr(C, packed(1))]
pub struct CABINET_INFO_A {
    pub CabinetPath: *mut core::ffi::c_void,
    pub CabinetFile: *mut core::ffi::c_void,
    pub DiskName: *mut core::ffi::c_void,
    pub SetId: u16,
    pub CabinetNumber: u16,
}
import "golang.org/x/sys/windows"

type CABINET_INFO_A struct {
	CabinetPath uintptr
	CabinetFile uintptr
	DiskName uintptr
	SetId uint16
	CabinetNumber uint16
}
type
  CABINET_INFO_A = packed record
    CabinetPath: Pointer;
    CabinetFile: Pointer;
    DiskName: Pointer;
    SetId: Word;
    CabinetNumber: Word;
  end;
const CABINET_INFO_A = extern struct {
    CabinetPath: ?*anyopaque,
    CabinetFile: ?*anyopaque,
    DiskName: ?*anyopaque,
    SetId: u16,
    CabinetNumber: u16,
};
type
  CABINET_INFO_A {.packed.} = object
    CabinetPath: pointer
    CabinetFile: pointer
    DiskName: pointer
    SetId: uint16
    CabinetNumber: uint16
align(1)
struct CABINET_INFO_A
{
    void* CabinetPath;
    void* CabinetFile;
    void* DiskName;
    ushort SetId;
    ushort CabinetNumber;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; CABINET_INFO_A サイズ: 16 バイト(x86)
dim st, 4    ; 4byte整数×4(構造体サイズ 16 / 4 切り上げ)
; CabinetPath : LPSTR (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; CabinetFile : LPSTR (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; DiskName : LPSTR (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; SetId : WORD (+12, 2byte)  wpoke st,12,値  /  値 = wpeek(st,12)
; CabinetNumber : WORD (+14, 2byte)  wpoke st,14,値  /  値 = wpeek(st,14)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; CABINET_INFO_A サイズ: 28 バイト(x64)
dim st, 7    ; 4byte整数×7(構造体サイズ 28 / 4 切り上げ)
; CabinetPath : LPSTR (+0, 8byte)  qpoke st,0,値 / qpeek(st,0)  ※IronHSPのみ。3.7/3.8は lpoke st,0,下位 : lpoke st,4,上位
; CabinetFile : LPSTR (+8, 8byte)  qpoke st,8,値 / qpeek(st,8)  ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; DiskName : LPSTR (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; SetId : WORD (+24, 2byte)  wpoke st,24,値  /  値 = wpeek(st,24)
; CabinetNumber : WORD (+26, 2byte)  wpoke st,26,値  /  値 = wpeek(st,26)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global CABINET_INFO_A, pack=1
    #field intptr CabinetPath
    #field intptr CabinetFile
    #field intptr DiskName
    #field short SetId
    #field short CabinetNumber
#endstruct

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