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
E_UNEXPECTED
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)

ICustomDestinationList

SetCurrentProcessExplicitAppUserModelID

Estensioni della barra delle applicazioni