SP_REGISTER_CONTROL_STATUSW struttura (setupapi.h)

Articolo
08/26/2023

La struttura SP_REGISTER_CONTROL_STATUS contiene informazioni su un file registrato o non registrato usando la direttiva RegisterDlls INF per registrare automaticamente le DLL in Windows 2000.

Quando SetupInstallFromInfSection invia una notifica SPFILENOTIFY_STARTREGISTRATION o SPFILENOTIFY_ENDREGISTRATION alla routine di callback, il chiamante deve fornire un puntatore a una struttura SP_REGISTER_CONTROL_STATUS nel parametro MsgHandler .

Sintassi

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

Members

cbSize

FileName

Percorso completo del file registrato o non registrato.

Win32Error

Per una notifica di SPFILENOTIFY_STARTREGISTRATION, questo membro non viene usato e deve essere impostato su NO_ERROR. Per una notifica di SPFILENOTIFY_ENDREGISTRATION, impostare su un codice di errore di sistema.

FailureCode

Per una notifica di SPFILENOTIFY_STARTREGISTRATION, questo membro non viene usato e deve essere impostato su SPREG_SUCCESS. Per una notifica SPFILENOTIFY_ENDREGISTRATION, impostare su uno dei codici di errore seguenti che indicano il risultato della registrazione.

Valore	Significato
SPREG_SUCCESS	Il file è stato registrato o non registrato correttamente. WinError non usato.
SPREG_LOADLIBRARY	LoadLibrary non è riuscito per il file. WinError contiene un codice di errore esteso dal componente.
SPREG_GETPROCADDR	GetProcAddress non è riuscito per il file. WinError contiene un codice di errore esteso dal componente.
SPREG_REGSVR	Errore restituito dal punto di ingresso DLLRegisterServer. WinError contiene un codice di errore esteso dal componente.
SPREG_DLLINSTALL	Errore restituito dal punto di ingresso DLLInstall. WinError contiene un codice di errore esteso dal componente.
SPREG_TIMEOUT	La registrazione del file o l'annullamento della registrazione supera il timeout specificato. WinError è impostato su ERROR_TIMEOUT.
SPREG_UNKNOWN	Registrazione file o annullamento della registrazione non riuscita per un motivo sconosciuto. WinError indica un codice di errore esteso dal componente.

Commenti

Nota

L'intestazione setupapi.h definisce SP_REGISTER_CONTROL_STATUS come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.