estructura SP_REGISTER_CONTROL_STATUSA (setupapi.h)

La estructura de SP_REGISTER_CONTROL_STATUS contiene información sobre un archivo que se está registrando o anulando el registro mediante la directiva RegisterDlls INF para registrar archivos DLL automáticamente en Windows 2000.

Cuando SetupInstallFromInfSection envía una notificación SPFILENOTIFY_STARTREGISTRATION o SPFILENOTIFY_ENDREGISTRATION a la rutina de devolución de llamada, el llamador debe proporcionar un puntero a una estructura SP_REGISTER_CONTROL_STATUS en el parámetro MsgHandler .

Sintaxis

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

Miembros

cbSize

FileName

Ruta de acceso completa del archivo que se está registrando o anulando el registro.

Win32Error

Para una notificación de SPFILENOTIFY_STARTREGISTRATION, este miembro no se usa y debe establecerse en NO_ERROR. Para una notificación de SPFILENOTIFY_ENDREGISTRATION, establezca en un código de error del sistema.

FailureCode

Para una notificación de SPFILENOTIFY_STARTREGISTRATION, este miembro no se usa y debe establecerse en SPREG_SUCCESS. Para una notificación de SPFILENOTIFY_ENDREGISTRATION, establezca en uno de los siguientes códigos de error que indican el resultado del registro.

Value	Significado
SPREG_SUCCESS	El archivo se registró correctamente o no se registró. WinError no se usa.
SPREG_LOADLIBRARY	Error de LoadLibrary para el archivo. WinError contiene un código de error extendido del componente.
SPREG_GETPROCADDR	Error de GetProcAddress para el archivo. WinError contiene un código de error extendido del componente.
SPREG_REGSVR	Error devuelto por el punto de entrada DLLRegisterServer. WinError contiene un código de error extendido del componente.
SPREG_DLLINSTALL	Error devuelto por el punto de entrada DLLInstall. WinError contiene un código de error extendido del componente.
SPREG_TIMEOUT	El registro de archivos o la anulación del registro superaron el tiempo de espera especificado. WinError se establece en ERROR_TIMEOUT.
SPREG_UNKNOWN	Error de registro o anulación del registro de archivos por un motivo desconocido. WinError indica un código de error extendido del componente.

Comentarios

Nota:

El encabezado setupapi.h define SP_REGISTER_CONTROL_STATUS como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado	setupapi.h

Vea también

Información general

SPFILENOTIFY_ENDREGISTRATION

SPFILENOTIFY_STARTREGISTRATION

SetupInstallFromInfSection

Estructuras