Funzione SetCurrentProcessExplicitAppUserModelID (shobjidl_core.h)

Specifica un ID modello utente applicazione univoco definito dall'applicazione (AppUserModelID) che identifica il processo corrente sulla barra delle applicazioni. Questo identificatore consente a un'applicazione di raggruppare i processi e le finestre associati sotto un singolo pulsante della barra delle applicazioni.

Sintassi

SHSTDAPI SetCurrentProcessExplicitAppUserModelID(
  [in] PCWSTR AppID
);

Parametri

[in] AppID

Tipo: PCWSTR

Puntatore a AppUserModelID da assegnare al processo corrente.

Valore restituito

Tipo: HRESULT

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Questo metodo deve essere chiamato durante la routine di avvio iniziale di un'applicazione prima che l'applicazione presenti qualsiasi interfaccia utente o faccia qualsiasi manipolazione del relativo jump Elenchi. Ciò include qualsiasi chiamata a SHAddToRecentDocs.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shobjidl_core.h (include Shobjidl.h)
Libreria	Shell32.lib
DLL	Shell32.dll (versione 6.1 o successiva)

Vedi anche

ID modello utente applicazione (AppUserModelIDs)

GetCurrentProcessExplicitAppUserModelID

Estensioni della barra delle applicazioni