SP_REGISTER_CONTROL_STATUSW-Struktur (setupapi.h)

Artikel
03/01/2024

Die SP_REGISTER_CONTROL_STATUS-Struktur enthält Informationen zu einer Datei, die mithilfe der RegisterDlls-INF-Anweisung registriert oder aufgehoben wird, um DLLs unter Windows 2000 selbst zu registrieren.

Wenn SetupInstallFromInfSection eine SPFILENOTIFY_STARTREGISTRATION - oder SPFILENOTIFY_ENDREGISTRATION-Benachrichtigung an die Rückrufroutine sendet, muss der Aufrufer einen Zeiger auf eine SP_REGISTER_CONTROL_STATUS Struktur im MsgHandler-Parameter bereitstellen.

Syntax

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

Member

cbSize

FileName

Vollqualifizierter Pfad der Datei, die registriert oder nicht registriert wird.

Win32Error

Für eine SPFILENOTIFY_STARTREGISTRATION Benachrichtigung wird dieses Element nicht verwendet und sollte auf NO_ERROR festgelegt werden. Legen Sie für eine SPFILENOTIFY_ENDREGISTRATION Benachrichtigung auf einen Systemfehlercode fest.

FailureCode

Für eine SPFILENOTIFY_STARTREGISTRATION Benachrichtigung wird dieses Element nicht verwendet und sollte auf SPREG_SUCCESS festgelegt werden. Legen Sie für eine SPFILENOTIFY_ENDREGISTRATION Benachrichtigung auf einen der folgenden Fehlercodes fest, die das Ergebnis der Registrierung angeben.

Wert	Bedeutung
SPREG_SUCCESS	Die Datei wurde erfolgreich registriert oder aufgehoben. WinError wird nicht verwendet.
SPREG_LOADLIBRARY	LoadLibrary ist für die Datei fehlgeschlagen. WinError enthält einen erweiterten Fehlercode aus der Komponente.
SPREG_GETPROCADDR	Fehler bei GetProcAddress für die Datei. WinError enthält einen erweiterten Fehlercode aus der Komponente.
SPREG_REGSVR	Fehler beim DLLRegisterServer-Einstiegspunkt. WinError enthält einen erweiterten Fehlercode aus der Komponente.
SPREG_DLLINSTALL	Fehler beim DllInstall-Einstiegspunkt. WinError enthält einen erweiterten Fehlercode aus der Komponente.
SPREG_TIMEOUT	Die Dateiregistrierung oder -aufhebung hat das angegebene Timeout überschritten. WinError ist auf ERROR_TIMEOUT festgelegt.
SPREG_UNKNOWN	Fehler bei der Dateiregistrierung oder -aufhebung aus einem unbekannten Grund. WinError gibt einen erweiterten Fehlercode aus der Komponente an.

Hinweise

Hinweis

Der setupapi.h-Header definiert SP_REGISTER_CONTROL_STATUS als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	setupapi.h

Weitere Informationen

Übersicht

SPFILENOTIFY_ENDREGISTRATION

SPFILENOTIFY_STARTREGISTRATION

SetupInstallFromInfSection

Strukturen

Share via