Função SetupSetSourceListA (setupapi.h)

Artigo
08/26/2023

[Essa função está disponível para uso nos sistemas operacionais indicados na seção Requisitos. Ele poderá ser alterado ou ficar 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 SetupSetSourceList permite que o chamador defina a lista de fontes de instalação para o usuário atual ou o sistema (comum a todos os usuários).

Sintaxe

WINSETUPAPI BOOL SetupSetSourceListA(
  [in] DWORD Flags,
  [in] PCSTR *SourceList,
  [in] UINT  SourceCount
);

Parâmetros

[in] Flags

Especifica o tipo de lista. Esse parâmetro pode ser uma combinação dos seguintes valores.

SRCLIST_SYSTEM

A lista é a lista mru (usado mais recentemente por sistema) armazenada no registro. O chamador deve ser um membro do grupo local de administradores.

SRCLIST_USER

A lista é a lista mru por usuário armazenada no registro.

SRCLIST_TEMPORARY

A lista especificada é temporária e será a única lista acessível ao processo atual até que SetupCancelTemporarySourceList seja chamado ou SetSourceList seja chamado novamente.

Importante Se uma lista temporária for definida, as fontes não serão adicionadas ou excluídas do sistema ou das listas de usuários, mesmo que chamadas subsequentes para SetupAddToSourceList ou SetupRemoveFromSourceList especifiquem explicitamente essas listas.

Nota Um dos sinalizadores de SRCLIST_SYSTEM, SRCLIST_USER ou SRCLIST_TEMPORARY deve ser especificado.

SRCLIST_NOBROWSE

O usuário não tem permissão para adicionar ou alterar fontes quando SetupPromptForDisk é usado. Normalmente, esse sinalizador é usado em combinação com o sinalizador SRCLIST_TEMPORARY.

[in] SourceList

Ponteiro para uma matriz de cadeias de caracteres a serem usadas como a lista de origem, conforme especificado pelo parâmetro Flags .

[in] SourceCount

Número de elementos na matriz apontada por SourceList.

Retornar valor

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.

Comentários

Observação

O cabeçalho setupapi.h define SetupSetSourceList 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

Requisito	Valor
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]
Plataforma de Destino	Windows
Cabeçalho	setupapi.h
Biblioteca	Setupapi.lib
DLL	Setupapi.dll