Compartir a través de

estructura SP_REGISTER_CONTROL_STATUSW (setupapi.h)

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

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

Sintaxis

typedef struct _SP_REGISTER_CONTROL_STATUSW {
  DWORD  cbSize;
  PCWSTR FileName;
  DWORD  Win32Error;
  DWORD  FailureCode;
} SP_REGISTER_CONTROL_STATUSW, *PSP_REGISTER_CONTROL_STATUSW;

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.

Valor Significado
SPREG_SUCCESS
 El archivo se registró correctamente o no se registró. no se usa winError.
SPREG_LOADLIBRARY
 error de LoadLibrary para el archivo. WinError contiene un código de error extendido del componente.
SPREG_GETPROCADDR
 error getProcAddress para el archivo. WinError contiene un código de error extendido del componente.
SPREG_REGSVR
 error devuelto punto de entrada DLLRegisterServer. WinError contiene un código de error extendido del componente.
SPREG_DLLINSTALL
 DLLInstall error devuelto por el punto de entrada. 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 está establecido 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.

Observaciones

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 Conventions for Function Prototypes.

Requisitos

Requisito Valor
cliente mínimo admitido Windows XP [solo aplicaciones de escritorio]
servidor mínimo admitido Windows Server 2003 [solo aplicaciones de escritorio]
encabezado de setupapi.h

Consulte también

información general

SPFILENOTIFY_ENDREGISTRATION

SPFILENOTIFY_STARTREGISTRATION

SetupInstallFromInfSection

estructuras de

  • Last updated on