Metodo ICustomDestinationList::SetAppID (shobjidl_core.h)
Specifica un ID modello utente applicazione univoco (AppUserModelID) per l'applicazione il cui pulsante della barra delle applicazioni conterrà il jump list personalizzato compilato tramite i metodi di questa interfaccia. È facoltativo.
Sintassi
HRESULT SetAppID(
[in] LPCWSTR pszAppID
);
Parametri
[in] pszAppID
Tipo: LPCWSTR
Puntatore all'AppUserModelID del processo o dell'applicazione la cui rappresentazione della barra delle applicazioni riceve la Jump List.
Valore restituito
Tipo: HRESULT
Restituisce S_OK in caso di esito positivo o un valore di errore, incluso quanto segue:
| Codice restituito | Descrizione |
|---|---|
|
Questo metodo è stato chiamato dopo ICustomDestinationList::BeginList. Il processo di compilazione dell'elenco è già in esecuzione con un determinato AppUserModelID, dedotto dal sistema o impostato tramite una chiamata a SetAppID prima della chiamata a BeginList. Dopo che è in corso un'operazione di compilazione dell'elenco, appUserModelID non può essere modificato finché non viene chiamato CommitList o AbortList . |
Commenti
Se un'applicazione ha un AppUserModelID esplicito, è necessario chiamare SetAppID prima di chiamare ICustomDestinationList::BeginList o ICustomDestinationList::GetRemovedDestinations.
Dopo che un AppUserModelID viene specificato tramite il metodo SetAppID di un oggetto, l'Oggetto AppUserModelID viene salvato nell'oggetto per la durata dell'oggetto, purché non venga sovrascritto da un'altra chiamata a SetAppID.
Alcune applicazioni non dichiarano un AppUserModelID esplicito e non devono chiamare questo metodo. In tal caso, l'identità dell'applicazione viene dedotta quando vengono chiamati ICustomDestinationList::BeginList o ICustomDestinationList::GetRemovedDestinations . Tuttavia, esiste un vantaggio per le prestazioni nell'evitare tali calcoli, pertanto le applicazioni che forniscono jump Elenchi personalizzate sono incoraggiate a usare appUserModelID espliciti.
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)