Partager via

structure SP_REGISTER_CONTROL_STATUSW (setupapi.h)

La structure SP_REGISTER_CONTROL_STATUS contient des informations sur un fichier inscrit ou non inscrit à l’aide de la directive RegisterDlls INF pour inscrire automatiquement 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 inscrit ou non inscrit.

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 l’un des codes d’échec suivants qui indiquent le résultat de l’inscription.

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

Remarques

Note

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. Le mélange 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.

Exigences

Exigence Valeur
client minimum pris en charge Windows XP [applications de bureau uniquement]
serveur minimum pris en charge Windows Server 2003 [applications de bureau uniquement]
d’en-tête setupapi.h

Voir aussi

Vue d’ensemble

SPFILENOTIFY_ENDREGISTRATION

SPFILENOTIFY_STARTREGISTRATION

SetupInstallFromInfSection

structures

  • Last updated on