Export (0) Print
Expand All

SP_REGISTER_CONTROL_STATUS structure

The SP_REGISTER_CONTROL_STATUS structure contains information about a file being registered or unregistered using the RegisterDlls INF directive to self-register DLLs on Windows 2000.

When SetupInstallFromInfSection sends a SPFILENOTIFY_STARTREGISTRATION or SPFILENOTIFY_ENDREGISTRATION notification to the callback routine, the caller must provide a pointer to a SP_REGISTER_CONTROL_STATUS structure in the MsgHandler parameter.

Syntax


typedef struct _SP_REGISTER_CONTROL_STATUS {
  DWORD cbsize;
  PCSTR FileName;
  DWORD Win32Error;
  DWORD FailureCode;
} SP_REGISTER_CONTROL_STATUS, *PSP_REGISTER_CONTROL_STATUS;

Members

cbsize

Size of the structure, in bytes.

FileName

Fully-qualified path of the file being registered or unregistered.

Win32Error

For an SPFILENOTIFY_STARTREGISTRATION notification, this member is not used and should be set to NO_ERROR. For a SPFILENOTIFY_ENDREGISTRATION notification, set to a system error code.

FailureCode

For a SPFILENOTIFY_STARTREGISTRATION notification, this member is not used and should be set to SPREG_SUCCESS. For a SPFILENOTIFY_ENDREGISTRATION notification, set to one of the following failure codes that indicate the result of registration.

ValueMeaning
SPREG_SUCCESS

The file was successfully registered or unregistered. WinError not used.

SPREG_LOADLIBRARY

LoadLibrary failed for the file. WinError contains an extended error code from the component.

SPREG_GETPROCADDR

GetProcAddress failed for the file. WinError contains an extended error code from the component.

SPREG_REGSVR

DLLRegisterServer entry point returned failure. WinError contains an extended error code from the component.

SPREG_DLLINSTALL

DLLInstall entry point returned failure. WinError contains an extended error code from the component.

SPREG_TIMEOUT

The file registration or unregistration exceeded the specified timeout. WinError is set to ERROR_TIMEOUT.

SPREG_UNKNOWN

File registration or unregistration failed for an unknown reason. WinError indicates an extended error code from the component.

 

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Setupapi.h

See also

Overview
Structures
SetupInstallFromInfSection
SPFILENOTIFY_STARTREGISTRATION
SPFILENOTIFY_ENDREGISTRATION

 

 

Community Additions

ADD
Show:
© 2015 Microsoft