Funzione SaferiIsExecutableFileType (winsafer.h)

Articolo
03/04/2024

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

Eseguire Secpol.msc.
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)

Condividi tramite