estrutura SP_REGISTER_CONTROL_STATUSA (setupapi.h)

  • Artigo

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

Quando SetupInstallFromInfSection envia uma notificação de SPFILENOTIFY_STARTREGISTRATION ou SPFILENOTIFY_ENDREGISTRATION para a rotina de retorno de chamada, o chamador deve fornecer um ponteiro para uma estrutura 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 um código de erro do sistema.

FailureCode

Para uma notificação de SPFILENOTIFY_STARTREGISTRATION, esse membro não é usado e deve ser definido como SPREG_SUCCESS. Para uma notificação de 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
 Falha de LoadLibrary para o arquivo. O WinError contém um código de erro estendido do componente.
SPREG_GETPROCADDR
 Falha em GetProcAddress para o arquivo. O WinError contém um código de erro estendido do componente.
SPREG_REGSVR
 O ponto de entrada DLLRegisterServer retornou falha. O WinError contém um código de erro estendido do componente.
SPREG_DLLINSTALL
 Falha retornada do ponto de entrada DLLInstall. O WinError contém um código de erro estendido do componente.
SPREG_TIMEOUT
 O registro ou cancelamento do registro de arquivo excedeu o tempo limite especificado. O WinError está definido como ERROR_TIMEOUT.
SPREG_UNKNOWN
 Falha no registro ou cancelamento do registro de arquivos por um motivo desconhecido. WinError indica um código de erro estendido do componente.

Comentários

Observação

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 de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

   
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho setupapi.h

Confira também

Visão geral

SPFILENOTIFY_ENDREGISTRATION

SPFILENOTIFY_STARTREGISTRATION

SetupInstallFromInfSection

Estruturas