Partager via


structure SP_REGISTER_CONTROL_STATUSW (setupapi.h)

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_STATUSW {
  DWORD  cbSize;
  PCWSTR FileName;
  DWORD  Win32Error;
  DWORD  FailureCode;
} SP_REGISTER_CONTROL_STATUSW, *PSP_REGISTER_CONTROL_STATUSW;

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

Condition requise Valeur
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

Vue d'ensemble

SPFILENOTIFY_ENDREGISTRATION

SPFILENOTIFY_STARTREGISTRATION

SetupInstallFromInfSection

Structures