Função SetupIterateCabinetA (setupapi.h)

Artigo
11/20/2024

[Essa função está disponível para uso nos sistemas operacionais indicados na seção Requisitos. Ele pode estar alterado ou indisponível em versões subsequentes. SetupAPI não deve mais ser usado para instalar aplicativos. Em vez disso, use o Windows Installer para desenvolver instaladores de aplicativos. SetupAPI continua a ser usado para instalar drivers de dispositivo.]

A função SetupIterateCabinet itera em todos os arquivos em um gabinete e envia uma notificação para uma função de retorno de chamada para cada arquivo encontrado.

Sintaxe

WINSETUPAPI BOOL SetupIterateCabinetA(
  [in] PCSTR               CabinetFile,
  [in] DWORD               Reserved,
  [in] PSP_FILE_CALLBACK_A MsgHandler,
  [in] PVOID               Context
);

Parâmetros

[in] CabinetFile

Arquivo de gabinete (.CAB) para iterar.

[in] Reserved

Não usado no momento.

[in] MsgHandler

Ponteiro para uma rotina de FileCallback que processará as notificações SetupIterateCabinet retorna conforme itera pelos arquivos no arquivo de gabinete. A rotina de retorno de chamada pode retornar um valor que especifica se deseja descompactar, copiar ou ignorar o arquivo.

[in] Context

Valor de contexto que é passado para a rotina especificada em msgHandler. Isso permite que a rotina de retorno de chamada rastreie valores entre notificações, sem precisar usar variáveis globais.

Valor de retorno

Se a função for bem-sucedida, o valor retornado será um valor diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Observações

Nota

O cabeçalho setupapi.h define SetupIterateCabinet 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. 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]
da Plataforma de Destino	Windows
cabeçalho	setupapi.h
biblioteca	Setupapi.lib
de DLL	Setupapi.dll
conjunto de API	ext-ms-win-setupapi-classinstallers-l1-1-2 (introduzido no Windows 10, versão 10.0.14393)

Consulte também

Funções

Visão geral

Compartilhar via