Compartilhar via


Função SetupSetSourceListA (setupapi.h)

[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 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 valores a seguir.

SRCLIST_SYSTEM

A lista é a lista mru (uso mais recente) 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 se as chamadas subsequentes para SetupAddToSourceList ou SetupRemoveFromSourceList especificar explicitamente essas listas.
 
Observação 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. Esse sinalizador normalmente é 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 apontado por SourceList.

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 SetupSetSourceList 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]
da Plataforma de Destino Windows
cabeçalho setupapi.h
biblioteca Setupapi.lib
de DLL Setupapi.dll

Consulte também

Funções

Visão geral

SetupAddToSourceList

SetupCancelTemporarySourceList

SetupRemoveFromSourceList