ホーム › System.Threading › InitOnceInitialize

InitOnceInitialize

関数

一回限り初期化構造体(INIT_ONCE)を初期化する。

DLLKERNEL32.dll呼出規約winapi対応OSWindows Vista 以降

シグネチャ

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

void InitOnceInitialize(
    INIT_ONCE* InitOnce
);

パラメーター

名前	型	方向	説明
InitOnce	INIT_ONCE*	out	1 回限りの初期化構造体へのポインター。

戻り値の型: void

公式ドキュメント

1 回限りの初期化構造体を初期化します。

解説(Remarks)

InitOnceInitialize 関数は、1 回限りの初期化構造体を動的に初期化するために使用します。構造体を静的に初期化するには、定数 INIT_ONCE_STATIC_INIT を構造体変数に割り当てます。

この関数を使用するアプリケーションをコンパイルするには、_WIN32_WINNT を 0x0600 以降として定義します。詳細については、 Using the Windows Headers を参照してください。

1 回限りの初期化オブジェクトは、移動もコピーもできません。プロセスは初期化オブジェクトを変更してはならず、論理的に不透明なものとして扱う必要があります。1 回限りの初期化オブジェクトの管理には、1 回限りの初期化関数のみを使用してください。

例

次の例では、InitOnceInitialize を呼び出して、InitOnce という名前の 1 回限りの初期化構造体を初期化します。あるいは、Using One-Time Initialization に示すように、構造体をグローバル変数として宣言することもできます。


//Requires Windows Vista, Windows Server 2008 or later
#define _WIN32_WINNT 0x0600

#include <windows.h>

BOOL StartInitialization()
{
    INIT_ONCE InitOnce;

    InitOnceInitialize(&InitOnce);

    //...
    return TRUE;
}

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

各言語での呼び出し定義

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

void InitOnceInitialize(
    INIT_ONCE* InitOnce
);

[DllImport("KERNEL32.dll", ExactSpelling = true)]
static extern void InitOnceInitialize(
    IntPtr InitOnce   // INIT_ONCE* out
);

<DllImport("KERNEL32.dll", ExactSpelling:=True)>
Public Shared Sub InitOnceInitialize(
    InitOnce As IntPtr   ' INIT_ONCE* out
)
End Sub

' InitOnce : INIT_ONCE* out
Declare PtrSafe Sub InitOnceInitialize Lib "kernel32" ( _
    ByVal InitOnce As LongPtr)
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。

import ctypes
from ctypes import wintypes

InitOnceInitialize = ctypes.windll.kernel32.InitOnceInitialize
InitOnceInitialize.restype = None
InitOnceInitialize.argtypes = [
    ctypes.c_void_p,  # InitOnce : INIT_ONCE* out
]

require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('KERNEL32.dll')
InitOnceInitialize = Fiddle::Function.new(
  lib['InitOnceInitialize'],
  [
    Fiddle::TYPE_VOIDP,  # InitOnce : INIT_ONCE* out
  ],
  Fiddle::TYPE_VOID)

#[link(name = "kernel32")]
extern "system" {
    fn InitOnceInitialize(
        InitOnce: *mut INIT_ONCE  // INIT_ONCE* out
    );
}
// crates: windows-sys provides ready-made bindings for this API.

$sig = @"
[DllImport("KERNEL32.dll")]
public static extern void InitOnceInitialize(IntPtr InitOnce);
"@
$api = Add-Type -MemberDefinition $sig -Name 'KERNEL32_InitOnceInitialize' -Namespace Win32 -PassThru
# $api::InitOnceInitialize(InitOnce)

#uselib "KERNEL32.dll"
#func global InitOnceInitialize "InitOnceInitialize" sptr
; InitOnceInitialize varptr(InitOnce)
; InitOnce : INIT_ONCE* out -> "sptr"

出力引数:

#uselib "KERNEL32.dll"
#func global InitOnceInitialize "InitOnceInitialize" var
; InitOnceInitialize InitOnce
; InitOnce : INIT_ONCE* out -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "KERNEL32.dll"
#func global InitOnceInitialize "InitOnceInitialize" sptr
; InitOnceInitialize varptr(InitOnce)
; InitOnce : INIT_ONCE* out -> "sptr"
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。