Função SetupConfigureWmiFromInfSectionA (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 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 de 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.

Bandeira	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 qualquer conjunto de informações de segurança 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.

Valor de retorno

Essa função retorna WINSETUPAPI BOOL.

Observações

Nas versões anteriores do SetupAPI, as informações do WMI em arquivos INF são expostas a todos os usuários e o acesso só pode 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.

Nota

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 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	Nenhum com suporte
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

especificando um descritor de segurança de um arquivo INF

Compartilhar via