Funzione SaferiIsExecutableFileType (winsafer.h)

  • Articolo

La funzione SaferiIsExecutableFileType determina se un file specificato è un file eseguibile. Le applicazioni usano questa funzione per determinare se un file è un file eseguibile e, se si tratta, l'applicazione può prendere precauzioni di sicurezza per evitare di richiamare codice non attendibile.

Sintassi

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

Parametri

[in] szFullPathname

Puntatore a una stringa di caratteri Unicode con terminazione null per il nome del file. Il percorso è facoltativo perché viene valutata solo l'estensione del nome file. La valutazione dell'estensione del nome file non è distinzione tra maiuscole e minuscole. Questo parametro non può essere NULL o una stringa vuota e il file specificato deve includere un'estensione del nome file.

[in] bFromShellExecute

Valore booleano che determina se i file .exe vengono trattati come file eseguibili per la valutazione del tipo di file. Impostare questo valore su TRUE per omettere .exe file dalla valutazione o su FALSE per includerli.

Valore restituito

Se la funzione riconosce correttamente l'estensione del nome file come tipo di file eseguibile, il valore restituito è TRUE.

Se la funzione ha esito negativo o se szFullPath identifica un nome file con un'estensione non eseguibile, la funzione restituisce FALSE.

Commenti

Le estensioni del nome file seguenti sono esempi di tipi di file eseguibili. L'elenco non è completo.

  • .bat
  • .cmd
  • .com
  • EXE
  • .js
  • lnk
  • .pif
  • .pl
  • .shs
  • .url
  • .vbs
Lo snap-in Microsoft Management Console (MMC) dei criteri di sicurezza (Secpol.msc) controlla quali estensioni sono considerati tipi di file eseguibili.

Per visualizzare o modificare le estensioni considerate tipi di file eseguibili

  1. Eseguire Secpol.msc.
  2. Espandere Criteri di restrizione software e quindi fare doppio clic su Tipi di file designati.
Nota Per visualizzare la pagina delle proprietà Tipi di file designata , potrebbe essere necessario creare il nodo Criteri di restrizione software . Per creare il nodo Criteri di restrizione software , seguire le istruzioni visualizzate quando si espandono Criteri di restrizione software.
 

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione winsafer.h
Libreria Advapi32.lib
DLL Advapi32.dll
Set di API ext-ms-win-advapi32-safer-l1-1-0 (introdotto in Windows 8)