PINIT_ONCE_FN funzione di callback (synchapi.h)

Funzione di callback definita dall'applicazione. Specificare un puntatore a questa funzione quando si chiama la funzione InitOnceExecuteOnce . Il tipo di PINIT_ONCE_FN definisce un puntatore a questa funzione di callback. InitOnceCallback è un segnaposto per il nome della funzione definita dall'applicazione.

Sintassi

PINIT_ONCE_FN PinitOnceFn;

BOOL PinitOnceFn(
  [in, out]           PINIT_ONCE InitOnce,
  [in, out, optional] PVOID Parameter,
  [out, optional]     PVOID *Context
)
{...}

Parametri

[in, out] InitOnce

Puntatore alla struttura di inizializzazione one-time.

[in, out, optional] Parameter

Parametro facoltativo passato alla funzione di callback.

[out, optional] Context

I dati da archiviare con la struttura di inizializzazione monouso. Se Context fa riferimento a un valore, l'ordine basso INIT_ONCE_CTX_RESERVED_BITS del valore deve essere zero. Se Context punta a una struttura di dati, la struttura dei dati deve essere allineata a DWORD. Il contesto non deve essere un puntatore al codice in Arm32, perché i puntatori di codice Arm32 hanno sempre il set di bit meno significativo, vedere Arm32 ABI per informazioni dettagliate.

Valore restituito

Se la funzione restituisce TRUE, il blocco viene contrassegnato come inizializzato.

Se la funzione restituisce FALSE, il blocco non viene contrassegnato come inizializzato e la chiamata a InitOnceExecuteOnce ha esito negativo. Per comunicare informazioni aggiuntive sugli errori, chiamare SetLastError prima di restituire FALSE.

Commenti

Questa funzione può creare un oggetto di sincronizzazione e restituirlo nel parametro lpContext .

Per compilare un'applicazione che usa questa funzione, definire _WIN32_WINNT come 0x0600 o versioni successive. Per altre informazioni, vedere Uso delle intestazioni di Windows.

Esempio

Per un esempio che usa questa funzione, vedere Uso di One-Time Inizializzazione.

Requisiti

Vedi anche

InitOnceExecuteOnce

InitOnceInitialize

Funzioni di sincronizzazione