Metodo IHandlerActivationHost::BeforeCoCreateInstance (shobjidl_core.h)

Articolo
03/08/2023

Notifica a un client di ShellExecuteEx che un gestore sta per essere creato, dando al client l'opportunità di visualizzare l'interfaccia utente confermando l'uso di tale gestore o rifiutandolo restituendo un codice di errore specifico.

Sintassi

HRESULT BeforeCoCreateInstance(
  [in] REFCLSID        clsidHandler,
  [in] IShellItemArray *itemsBeingActivated,
  [in] IHandlerInfo    *handlerInfo
);

Parametri

[in] clsidHandler

Identifica il gestore.

[in] itemsBeingActivated

Oggetti dell'elemento shell che verranno passati al gestore. In genere c'è solo uno, ma in alcuni casi ci possono essere più di uno.

[in] handlerInfo

Fornisce l'accesso alle informazioni sul gestore che verrà richiamato. Questo oggetto supporta anche IHandlerInfo2 nelle versioni di Windows che supportano tale interfaccia.

Valore restituito

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT , HRESULT_FROM_WIN32(ERROR_CANCELLED) indica che la chiamata ShellExecute deve essere annullata, EXECUTE_E_LAUNCH_APPLICATION indica che questo gestore non deve essere usato, ma se è presente un altro deve essere usato.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8 [solo app desktop]
Server minimo supportato	Windows Server 2012 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shobjidl_core.h (include Shobjidl.h)

Vedi anche

IHandlerActivationHost

Share via