Compartilhar via

estrutura SP_REGISTER_CONTROL_STATUSA (setupapi.h)

A estrutura SP_REGISTER_CONTROL_STATUS contém informações sobre um arquivo sendo registrado ou não registrado usando a diretiva RegisterDlls INF para registrar automaticamente DLLs no Windows 2000.

Quando SetupInstallFromInfSection envia uma notificação SPFILENOTIFY_STARTREGISTRATION ou SPFILENOTIFY_ENDREGISTRATION para a rotina de retorno de chamada, o chamador deve fornecer um ponteiro para uma estrutura de SP_REGISTER_CONTROL_STATUS no parâmetro msgHandler .

Sintaxe

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

Membros

cbSize

FileName

Caminho totalmente qualificado do arquivo que está sendo registrado ou não registrado.

Win32Error

Para uma notificação de SPFILENOTIFY_STARTREGISTRATION, esse membro não é usado e deve ser definido como NO_ERROR. Para uma notificação de SPFILENOTIFY_ENDREGISTRATION, defina como umde código de erro do sistema .

FailureCode

Para uma notificação SPFILENOTIFY_STARTREGISTRATION, esse membro não é usado e deve ser definido como SPREG_SUCCESS. Para uma notificação SPFILENOTIFY_ENDREGISTRATION, defina como um dos seguintes códigos de falha que indicam o resultado do registro.

Valor Significado
SPREG_SUCCESS
 O arquivo foi registrado com êxito ou não registrado. WinError não usado.
SPREG_LOADLIBRARY
 LoadLibrary falhou no arquivo. WinError contém um código de erro estendido do componente.
SPREG_GETPROCADDR
 GetProcAddress falhou no arquivo. WinError contém um código de erro estendido do componente.
SPREG_REGSVR
 DLLRegisterServer falha retornada. WinError contém um código de erro estendido do componente.
SPREG_DLLINSTALL
 falha retornada do ponto de entrada de DLLInstall. WinError contém um código de erro estendido do componente.
SPREG_TIMEOUT
 O registro de arquivo ou o cancelamento do registro excedeu o tempo limite especificado. WinError está definido como ERROR_TIMEOUT.
SPREG_UNKNOWN
 Falha no registro ou cancelamento do registro de arquivo por um motivo desconhecido. WinError indica um código de erro estendido do componente.

Observações

Nota

O cabeçalho setupapi.h define SP_REGISTER_CONTROL_STATUS como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows XP [somente aplicativos da área de trabalho]
servidor com suporte mínimo Windows Server 2003 [somente aplicativos da área de trabalho]
cabeçalho setupapi.h

Consulte também

Visão geral

SPFILENOTIFY_ENDREGISTRATION

SPFILENOTIFY_STARTREGISTRATION

SetupInstallFromInfSection

estruturas

  • Last updated on