SP_REGISTER_CONTROL_STATUSA structure (setupapi.h)

Article
08/26/2023

La structure SP_REGISTER_CONTROL_STATUS contient des informations sur l’inscription ou la désinscription d’un fichier à l’aide de la directive INF RegisterDlls pour auto-inscrire des DLL sur Windows 2000.

Lorsque SetupInstallFromInfSection envoie une notification SPFILENOTIFY_STARTREGISTRATION ou SPFILENOTIFY_ENDREGISTRATION à la routine de rappel, l’appelant doit fournir un pointeur vers une structure SP_REGISTER_CONTROL_STATUS dans le paramètre MsgHandler .

Syntaxe

typedef struct _SP_REGISTER_CONTROL_STATUSA {
  DWORD cbSize;
  PCSTR FileName;
  DWORD Win32Error;
  DWORD FailureCode;
} SP_REGISTER_CONTROL_STATUSA, *PSP_REGISTER_CONTROL_STATUSA;

Membres

cbSize

FileName

Chemin complet du fichier en cours d’inscription ou de désinscription.

Win32Error

Pour une notification SPFILENOTIFY_STARTREGISTRATION, ce membre n’est pas utilisé et doit être défini sur NO_ERROR. Pour une notification SPFILENOTIFY_ENDREGISTRATION, définissez sur un code d’erreur système.

FailureCode

Pour une notification SPFILENOTIFY_STARTREGISTRATION, ce membre n’est pas utilisé et doit être défini sur SPREG_SUCCESS. Pour une notification SPFILENOTIFY_ENDREGISTRATION, définissez sur l’un des codes d’échec suivants qui indiquent le résultat de l’inscription.

Valeur	Signification
SPREG_SUCCESS	Le fichier a été correctement enregistré ou annulé. WinError non utilisé.
SPREG_LOADLIBRARY	Échec de LoadLibrary pour le fichier. WinError contient un code d’erreur étendu du composant.
SPREG_GETPROCADDR	Échec de GetProcAddress pour le fichier. WinError contient un code d’erreur étendu du composant.
SPREG_REGSVR	Échec retourné du point d’entrée DLLRegisterServer. WinError contient un code d’erreur étendu du composant.
SPREG_DLLINSTALL	Échec retourné du point d’entrée DLLInstall. WinError contient un code d’erreur étendu du composant.
SPREG_TIMEOUT	L’inscription ou la désinscription du fichier a dépassé le délai d’expiration spécifié. WinError est défini sur ERROR_TIMEOUT.
SPREG_UNKNOWN	L’inscription ou l’annulation de l’inscription du fichier a échoué pour une raison inconnue. WinError indique un code d’erreur étendu du composant.

Remarques

Notes

L’en-tête setupapi.h définit SP_REGISTER_CONTROL_STATUS en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise


Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
En-tête	setupapi.h

Voir aussi

Présentation

SPFILENOTIFY_ENDREGISTRATION

SPFILENOTIFY_STARTREGISTRATION

SetupInstallFromInfSection

Structures

Partager via