InitOnceComplete, fonction (synchapi.h)

Article
08/26/2023

Termine l’initialisation ponctuelle démarrée avec la fonction InitOnceBeginInitialize .

Syntaxe

BOOL InitOnceComplete(
  [in, out]      LPINIT_ONCE lpInitOnce,
  [in]           DWORD       dwFlags,
  [in, optional] LPVOID      lpContext
);

Paramètres

[in, out] lpInitOnce

Pointeur vers la structure d’initialisation à usage unique.

[in] dwFlags

Ce paramètre peut être l’un des indicateurs suivants.

Valeur	Signification
INIT_ONCE_ASYNC 0x00000002UL	Fonctionne en mode asynchrone. Cela permet à plusieurs tentatives de saisie semi-automatique de s’exécuter en parallèle. Cet indicateur doit correspondre à l’indicateur passé dans l’appel correspondant à la fonction InitOnceBeginInitialize . Cet indicateur ne peut pas être combiné avec INIT_ONCE_INIT_FAILED.
INIT_ONCE_INIT_FAILED 0x00000004UL	La tentative d’initialisation a échoué. Cet indicateur ne peut pas être combiné avec INIT_ONCE_ASYNC. Pour échouer une initialisation asynchrone, il suffit de l’abandonner (autrement dit, n’appelez pas la fonction InitOnceComplete ).

[in, optional] lpContext

Pointeur vers les données à stocker avec la structure d’initialisation à usage unique. Ces données sont retournées dans le paramètre lpContext passé aux appels suivants à la fonction InitOnceBeginInitialize . Si lpContext pointe vers une valeur, la INIT_ONCE_CTX_RESERVED_BITS d’ordre inférieur de la valeur doit être égale à zéro. Si lpContext pointe vers une structure de données, la structure de données doit être alignée sur DWORD.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Pour compiler une application qui utilise cette fonction, définissez _WIN32_WINNT comme 0x0600 ou version ultérieure. Pour plus d’informations, consultez Utilisation des en-têtes Windows.

Exemples

Pour obtenir un exemple qui utilise cette fonction, consultez Utilisation de One-Time Initialisation.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau \| applications UWP]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau \| applications UWP]
Plateforme cible	Windows
En-tête	synchapi.h (inclure Windows.h sur Windows 7, Windows Server 2008 Windows Server 2008 R2)
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll

Voir aussi

InitOnceBeginInitialize

Initialisation à usage unique

Fonctions de synchronisation

Partager via