다음을 통해 공유

SP_REGISTER_CONTROL_STATUSA 구조체(setupapi.h)

  • 아티클

SP_REGISTER_CONTROL_STATUS 구조에는 Windows 2000에서 DLL을 자체 등록하기 위해 RegisterDlls INF 지시문을 사용하여 등록 또는 등록 취소되는 파일에 대한 정보가 포함되어 있습니다.

SetupInstallFromInfSection이 콜백 루틴에 SPFILENOTIFY_STARTREGISTRATION 또는 SPFILENOTIFY_ENDREGISTRATION 알림을 보내는 경우 호출자는 MsgHandler 매개 변수의 SP_REGISTER_CONTROL_STATUS 구조에 대한 포인터를 제공해야 합니다.

구문

typedef struct _SP_REGISTER_CONTROL_STATUSA {
  DWORD cbSize;
  PCSTR FileName;
  DWORD Win32Error;
  DWORD FailureCode;
} SP_REGISTER_CONTROL_STATUSA, *PSP_REGISTER_CONTROL_STATUSA;

멤버

cbSize

FileName

등록되거나 등록되지 않은 파일의 정규화된 경로입니다.

Win32Error

SPFILENOTIFY_STARTREGISTRATION 알림의 경우 이 멤버는 사용되지 않으며 NO_ERROR 설정해야 합니다. SPFILENOTIFY_ENDREGISTRATION 알림의 경우 를 시스템 오류 코드로 설정합니다.

FailureCode

SPFILENOTIFY_STARTREGISTRATION 알림의 경우 이 멤버는 사용되지 않으며 SPREG_SUCCESS 설정해야 합니다. SPFILENOTIFY_ENDREGISTRATION 알림의 경우 등록 결과를 나타내는 다음 오류 코드 중 하나로 설정합니다.

값 의미
SPREG_SUCCESS
 파일이 성공적으로 등록되었거나 등록 취소되었습니다. WinError가 사용되지 않습니다.
SPREG_LOADLIBRARY
 파일에 대해 LoadLibrary가 실패했습니다. WinError 에는 구성 요소의 확장된 오류 코드가 포함되어 있습니다.
SPREG_GETPROCADDR
 파일에 대해 GetProcAddress 가 실패했습니다. WinError 에는 구성 요소의 확장된 오류 코드가 포함되어 있습니다.
SPREG_REGSVR
 DLLRegisterServer 진입점이 실패를 반환했습니다. WinError 에는 구성 요소의 확장된 오류 코드가 포함되어 있습니다.
SPREG_DLLINSTALL
 DLLInstall 진입점이 실패를 반환했습니다. WinError 에는 구성 요소의 확장된 오류 코드가 포함되어 있습니다.
SPREG_TIMEOUT
 파일 등록 또는 등록 취소가 지정된 시간 제한을 초과했습니다. WinError 는 ERROR_TIMEOUT 설정됩니다.
SPREG_UNKNOWN
 알 수 없는 이유로 파일 등록 또는 등록 취소에 실패했습니다. WinError 는 구성 요소의 확장된 오류 코드를 나타냅니다.

설명

참고

setupapi.h 헤더는 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 SP_REGISTER_CONTROL_STATUS 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

   
지원되는 최소 클라이언트 Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
머리글 setupapi.h

참고 항목

개요

SPFILENOTIFY_ENDREGISTRATION

SPFILENOTIFY_STARTREGISTRATION

SetupInstallFromInfSection

구조체