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

Vedi anche

GetProcessReference

SHSetInstanceExplorer

Set di API Windows