SP_REGISTER_CONTROL_STATUSA Struktur (setupapi.h)

Die SP_REGISTER_CONTROL_STATUS-Struktur enthält Informationen zu einer Datei, die mit der RegisterDlls INF-Direktive 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_STATUSA {
  DWORD cbSize;
  PCSTR FileName;
  DWORD Win32Error;
  DWORD FailureCode;
} SP_REGISTER_CONTROL_STATUSA, *PSP_REGISTER_CONTROL_STATUSA;

Angehörige

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 einen Systemfehlercodefest.

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 einen der folgenden Fehlercodes fest, die das Ergebnis der Registrierung angeben.

Wert	Bedeutung
SPREG_SUCCESS	Die Datei wurde erfolgreich registriert oder die Registrierung aufgehoben. WinError nicht verwendet.
SPREG_LOADLIBRARY	LoadLibrary- für die Datei fehlgeschlagen. WinError- enthält einen erweiterten Fehlercode aus der Komponente.
SPREG_GETPROCADDR	"GetProcAddress"- für die Datei fehlgeschlagen. WinError- enthält einen erweiterten Fehlercode aus der Komponente.
SPREG_REGSVR	DLLRegisterServer zurückgegebenen Einstiegspunkt. WinError- enthält einen erweiterten Fehlercode aus der Komponente.
SPREG_DLLINSTALL	DLLInstall Zurückgegebener Einstiegspunkt. WinError- enthält einen erweiterten Fehlercode aus der Komponente.
SPREG_TIMEOUT	Die Dateiregistrierung oder Registrierung hat das angegebene Timeout überschritten. WinError- ist auf ERROR_TIMEOUT festgelegt.
SPREG_UNKNOWN	Fehler bei der Dateiregistrierung oder -registrierung aus unbekanntem Grund. WinError- gibt einen erweiterten Fehlercode aus der Komponente an.

Bemerkungen

Anmerkung

Der header setupapi.h 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 Code, der nicht codierungsneutral ist, 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
mindestens unterstützte Client-	Windows XP [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Header-	setupapi.h

Siehe auch

Übersicht

SPFILENOTIFY_ENDREGISTRATION

SPFILENOTIFY_STARTREGISTRATION

SetupInstallFromInfSection-

Strukturen