Funzione SetProcessReference (shlwapi.h)
Fornisce un oggetto COM (Component Object Model) che consente alle estensioni shell ospitate e ad altri componenti di impedire la chiusura prematura del processo host. Il processo host è in genere Windows Explorer o Windows Internet Explorer, ma questa funzione può essere usata anche da altre applicazioni.
Sintassi
void SetProcessReference(
[in, optional] IUnknown *punk
);
Parametri
[in, optional] punk
Puntatore all'oggetto per il quale si desidera archiviare un riferimento. Questo valore può essere NULL.
Valore restituito
nessuno
Osservazioni
Windows Explorer e Internet Explorer possono usare SetProcessReference per consentire a componenti come le estensioni della shell di estendere la durata del processo. Altre applicazioni possono anche usare SetProcessReference per consentire la stessa funzionalità. Ad esempio, il ciclo di messaggi del browser e il desktop proxy usano SetProcessReference per consentire ad altri thread di estendere la durata.
Le applicazioni diverse da Windows Explorer e Internet Explorer che chiamano questa funzione potrebbero riscontrare problemi di compatibilità perché alcuni componenti usano SetProcessReference per rilevare se sono ospitati da Windows Explorer o Internet Explorer.
Il puntatore di interfaccia passato a SetProcessReference deve fare riferimento a un oggetto a thread libero.
Ogni volta che un componente chiama GetProcessReference, il sistema chiama il metodo AddRef prima di restituire il puntatore di interfaccia al componente chiamante. Il componente chiama quindi il metodo IUnknown::Release al termine dell'elaborazione. Il processo che chiama SetProcessReference non deve terminare mentre il conteggio dei riferimenti del puntatore di interfaccia fornito è diverso da zero.
Per altre informazioni su come i componenti usano i riferimenti al processo, vedere GetProcessReference.
Requisiti
| Client minimo supportato | Windows 8 [solo app desktop] |
| Server minimo supportato | Windows Server 2012 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | shlwapi.h |
| Libreria | Shlwapi.lib |
| DLL | Api-ms-win-shcore-thread-L1-1-0.dll |