PINIT_ONCE_FN回呼函式 (synchapi.h)
應用程式定義的回呼函式。 呼叫 InitOnceExecuteOnce 函式時，指定此函式的指標。 PINIT_ONCE_FN類型會定義這個回呼函式的指標。 InitOnceCallback 是應用程式定義函數名稱的佔位元。
語法
PINIT_ONCE_FN PinitOnceFn;
BOOL PinitOnceFn(
[in, out] PINIT_ONCE InitOnce,
[in, out, optional] PVOID Parameter,
[out, optional] PVOID *Context
)
{...}
參數
[in, out] InitOnce
一次性初始化結構的指標。
[in, out, optional] Parameter
傳遞至回呼函式的選擇性參數。
[out, optional] Context
要以一次性初始化結構儲存的數據。 如果 Context 參考值，則值的低序 INIT_ONCE_CTX_RESERVED_BITS 必須是零。 如果 Context 指向數據結構，則數據結構必須對齊 DWORD。 內容 不得為 Arm32 上的程式碼指標，因為 Arm32 程式代碼指標一律設定最小有效位，如需詳細資訊，請參閱 Arm32 ABI 。
傳回值
如果函式傳回 TRUE，區塊會標示為初始化。
如果函式傳回 FALSE，則區塊未標示為初始化，而且 InitOnceExecuteOnce 的呼叫會失敗。 若要傳達其他錯誤資訊，請在傳回 FALSE 之前呼叫 SetLastError。
備註
此函式可以建立同步處理物件，並在 lpContext 參數中傳回它。
若要編譯使用此函式的應用程式，請將_WIN32_WINNT定義為 0x0600 或更新版本。 如需詳細資訊，請參閱 使用 Windows 標頭。
範例
如需使用此函式的範例，請參閱 使用 One-Time 初始化。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | Windows Server 2008 [傳統型應用程式 |UWP 應用程式] |
| 目標平台 | Windows |
| 標頭 | synchapi.h (包含 Windows.h) |