Função SetupConfigureWmiFromInfSectionA (setupapi.h)

  • Artigo

[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 SetupConfigureWmiFromInfSection configura a segurança dos dados WMI expostos por um arquivo INF quando passados para a seção [DDInstall.WMI].

Ele é usado para estabelecer a segurança quando a versão da SetupAPI no sistema não dá suporte nativo às informações de segurança WMI fornecidas na seção DDInstall do arquivo INF.

Sintaxe

WINSETUPAPI BOOL SetupConfigureWmiFromInfSectionA(
  [in] HINF  InfHandle,
  [in] PCSTR SectionName,
  [in] DWORD Flags
);

Parâmetros

[in] InfHandle

Um identificador para um arquivo INF aberto.

[in] SectionName

Nome da seção no arquivo INF que contém informações de segurança WMI. Isso deve estar na forma de[DDinstall.WMI].

[in] Flags

Esse parâmetro pode ser definido da seguinte maneira.

Sinalizador Significado
SCWMI_CLOBBER_SECURITY
0x0001
 Se e somente se esse sinalizador estiver definido, as informações de segurança passadas para essa função substituirão quaisquer informações de segurança definidas em outro lugar no arquivo INF. Se esse sinalizador não existir e nenhuma informação de segurança existir no arquivo INF, a segurança será definida.

Retornar valor

Essa função retorna WINSETUPAPI BOOL.

Comentários

Em versões anteriores da SetupAPI, as informações de WMI em arquivos INF são expostas a todos os usuários e o acesso só poderia ser limitado gravando corretamente dados binários em uma chave do Registro. As versões atuais leem e processam informações de segurança WMI fornecidas pela seção DDInstall de um arquivo INF.

Observação

O cabeçalho setupapi.h define SetupConfigureWmiFromInfSection 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 Nenhum compatível
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

Confira também

Funções

Visão geral

Especificando um descritor de segurança de um arquivo INF