Função SetupDiSetClassInstallParamsW (setupapi.h)

A função SetupDiSetClassInstallParams define ou limpa parâmetros de instalação de classe para um conjunto de informações do dispositivo ou um elemento de informações de dispositivo específico.

Sintaxe

WINSETUPAPI BOOL SetupDiSetClassInstallParamsW(
  [in]           HDEVINFO                DeviceInfoSet,
  [in, optional] PSP_DEVINFO_DATA        DeviceInfoData,
  [in, optional] PSP_CLASSINSTALL_HEADER ClassInstallParams,
  [in]           DWORD                   ClassInstallParamsSize
);

Parâmetros

[in] DeviceInfoSet

Um identificador para o conjunto de informações do dispositivo para o qual definir parâmetros de instalação de classe.

[in, optional] DeviceInfoData

Um ponteiro para uma estrutura SP_DEVINFO_DATA que representa o dispositivo para o qual definir parâmetros de instalação de classe. Esse parâmetro é opcional e pode ser NULL. Se esse parâmetro for especificado, SetupDiSetClassInstallParams definirá os parâmetros de instalação de classe para o dispositivo especificado. Se esse parâmetro for NULL, SetupDiSetClassInstallParams definirá os parâmetros de instalação de classe associados a DeviceInfoSet.

[in, optional] ClassInstallParams

Um ponteiro para um buffer que contém os novos parâmetros de instalação de classe a serem usados. A estrutura SP_CLASSINSTALL_HEADER no início desse buffer deve ter seu campo cbSize definido como sizeof(SP_CLASSINSTALL_HEADER) e o campo InstallFunction deve ser definido como o código DI_FUNCTION que reflete o tipo de parâmetros contidos no restante do buffer.

Se ClassInstallParams não for especificado, os parâmetros de instalação da classe atual, se houver, serão limpos para o conjunto de informações do dispositivo ou elemento especificado.

[in] ClassInstallParamsSize

O tamanho, em bytes, do buffer ClassInstallParams . Se o buffer não for fornecido (ou seja, os parâmetros de instalação da classe estão sendo limpos), ClassInstallParamsSize deverá ser 0.

Retornar valor

A função retornará TRUE se for bem-sucedida. Caso contrário, ele retornará FALSE e o erro registrado poderá ser recuperado com uma chamada para GetLastError.

Comentários

Todos os parâmetros são validados antes de qualquer alteração ser feita. Portanto, um valor retornado de FALSE indica que nenhum parâmetro foi modificado.

Um efeito colateral da definição de parâmetros de instalação de classe é que o sinalizador DI_CLASSINSTALLPARAMS está definido. Se o chamador quiser definir os parâmetros, mas desabilitar seu uso, esse sinalizador deverá ser limpo por uma chamada para SetupDiSetDeviceInstallParams.

Se os parâmetros de instalação da classe forem limpos, o sinalizador DI_CLASSINSTALLPARAMS será redefinido.

Observação

O cabeçalho setupapi.h define SetupDiSetClassInstallParams 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 Disponível no Microsoft Windows 2000 e versões posteriores do Windows.
Plataforma de Destino Área de Trabalho
Cabeçalho setupapi.h (inclua Setupapi.h)
Biblioteca Setupapi.lib
Conjunto de APIs ext-ms-win-setupapi-classinstallers-l1-1-0 (introduzido no Windows 8)

Confira também

SetupDiGetClassInstallParams

SetupDiSetDeviceInstallParams