Compartilhar via


Função SaferiIsExecutableFileType (winsafer.h)

A função SaferiIsExecutableFileType determina se um arquivo especificado é um arquivo executável. Os aplicativos usam essa função para determinar se um arquivo é um arquivo executável e, se for, o aplicativo pode tomar precauções de segurança para impedir a invocação de código não confiável.

Sintaxe

BOOL SaferiIsExecutableFileType(
  [in] LPCWSTR szFullPathname,
  [in] BOOLEAN bFromShellExecute
);

Parâmetros

[in] szFullPathname

Ponteiro para uma cadeia de caracteres Unicode terminada em nulo para o nome do arquivo. O caminho é opcional porque apenas a extensão de nome de arquivo é avaliada. A avaliação da extensão de nome de arquivo não diferencia maiúsculas de minúsculas. Esse parâmetro não pode ser NULL ou uma cadeia de caracteres vazia e o arquivo especificado deve incluir uma extensão de nome de arquivo.

[in] bFromShellExecute

Valor booliano que determina se .exe arquivos são tratados como arquivos executáveis para a avaliação do tipo de arquivo. Defina esse valor como TRUE para omitir .exe arquivos da avaliação ou como FALSE para incluí-los.

Retornar valor

Se a função reconhecer com êxito a extensão do nome do arquivo como um tipo de arquivo executável, o valor retornado será TRUE.

Se a função falhar ou se szFullPath identificar um nome de arquivo com uma extensão inexecutável, a função retornará FALSE.

Comentários

As extensões de nome de arquivo a seguir são exemplos de tipos de arquivo executáveis. Esta não é uma lista completa.

  • .bat
  • .cmd
  • .com
  • .exe
  • .js
  • .lnk
  • .pif
  • .pl
  • .shs
  • .url
  • .vbs
O snap-in do Microsoft Management Console (MMC) de política de segurança (Secpol.msc) controla quais extensões são consideradas tipos de arquivo executáveis.

Para exibir ou modificar as extensões consideradas tipos de arquivo executáveis

  1. Execute Secpol.msc.
  2. Expanda Políticas de Restrição de Software e clique duas vezes em Tipos de Arquivo Designados.
Nota Para exibir a página de propriedades Tipos de Arquivo Designados , talvez seja necessário criar o nó Políticas de Restrição de Software . Para criar o nó Políticas de Restrição de Software , siga as instruções que aparecem quando você expande Políticas de Restrição de Software.
 

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 winsafer.h
Biblioteca Advapi32.lib
DLL Advapi32.dll
Conjunto de APIs ext-ms-win-advapi32-safer-l1-1-0 (introduzido em Windows 8)