Funzione ShellExecuteExA (shellapi.h)

Esegue un'operazione su un file specificato.

Sintassi

BOOL ShellExecuteExA(
  [in, out] SHELLEXECUTEINFOA *pExecInfo
);

Parametri

[in, out] pExecInfo

Tipo: SHELLEXECUTEINFO*

Puntatore a una struttura SHELLEXECUTEINFO che contiene e riceve informazioni sull'applicazione in esecuzione.

Valore restituito

Tipo: BOOL

Restituisce TRUE se l'operazione riesce; in caso contrario, FALSE. Chiamare GetLastError per informazioni sugli errori estese.

Commenti

Poiché ShellExecuteEx può delegare l'esecuzione alle estensioni shell (origini dati, gestori di menu di scelta rapida, implementazioni verbo) attivate tramite Component Object Model (COM), COM deve essere inizializzato prima di chiamare ShellExecuteEx . Alcune estensioni shell richiedono il tipo di apartment a thread singolo (STA) COM. In tal caso, COM deve essere inizializzato come illustrato di seguito:

CoInitializeEx(NULL, COINIT_APARTMENTTHREADED | COINIT_DISABLE_OLE1DDE)

Esistono istanze in cui ShellExecuteEx non usa uno di questi tipi di estensione shell e tali istanze non richiedono l'inizializzazione di COM. Tuttavia, è consigliabile inizializzare sempre COM prima di usare questa funzione.

Quando le DLL vengono caricate nel processo, si acquisisce un blocco noto come blocco del caricatore. La funzione DllMain viene sempre eseguita nel blocco del caricatore. È importante non chiamare ShellExecuteEx mentre si mantiene un blocco del caricatore. Poiché ShellExecuteEx è estendibile, è possibile caricare codice che non funziona correttamente in presenza di un blocco del caricatore, rischiando un deadlock e quindi un thread non risponde.

Con più monitor, se si specifica un HWND e si imposta il membro lpVerb della struttura SHELLEXECUTEINFO a cui punta lpExecInfo su "Properties", qualsiasi finestra creata da ShellExecuteEx potrebbe non essere visualizzata nella posizione corretta.

Se la funzione ha esito positivo, imposta il membro hInstApp della struttura SHELLEXECUTEINFO su un valore maggiore di 32. Se la funzione ha esito negativo, hInstApp viene impostato sul valore di errore SE_ERR_XXX che indica meglio la causa dell'errore. Anche se hInstApp viene dichiarato come HINSTANCE per la compatibilità con le applicazioni Windows a 16 bit, non è una vera HINSTANCE. Può essere eseguito il cast solo a un valore int e può essere confrontato solo con il valore 32 o il SE_ERR_XXX codici di errore.

I valori di errore SE_ERR_XXX vengono forniti per la compatibilità con ShellExecute. Per recuperare informazioni più accurate sull'errore, usare GetLastError. Può restituire uno dei valori seguenti.

Apertura di elementi da un URL È possibile registrare l'applicazione per l'attivazione quando vengono passati gli URL. È anche possibile specificare i protocolli supportati dall'applicazione. Per altre informazioni, vedi Registrazione dell'applicazione .

Supporto della catena di siti A partire da Windows 8, è possibile fornire un puntatore della catena di siti alla funzione ShellExecuteEx per supportare l'attivazione degli elementi con i servizi di tale sito. Per altre informazioni, vedere Avvio di applicazioni (ShellExecute, ShellExecuteEx, SHELLEXECUTEINFO).

Requisiti

Vedi anche

CoInitializeEx

IShellExecuteHook

Avvio di applicazioni (ShellExecute, ShellExecuteEx, SHELLEXECUTEINFO)

ShellExecute