Metodo IApplicationDocumentLists::SetAppID (shobjidl_core.h)
Specifica un ID modello utente applicazione univoco (AppUserModelID) per l'applicazione i cui elenchi di destinazione vengono recuperati. È facoltativo.
Sintassi
HRESULT SetAppID(
[in] LPCWSTR pszAppID
);
Parametri
[in] pszAppID
Tipo: LPCWSTR
Puntatore all'AppUserModelID del processo la cui rappresentazione del pulsante della barra delle applicazioni riceve il jump list.
Valore restituito
Tipo: HRESULT
Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .
Commenti
Se l'applicazione ha un AppUserModelID esplicito, questo metodo deve essere chiamato prima di chiamare GetList.
Dopo aver specificato un AppUserModelID tramite il metodo SetAppID di un oggetto, l'AppUserModelID viene salvato nell'oggetto per la durata dell'oggetto, specificando che non viene 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 deducibile quando viene chiamata IApplicationDocumentLists::GetList . Tuttavia, esiste un vantaggio per le prestazioni per evitare tali calcoli, in modo che le applicazioni che forniscono jump list personalizzate siano incoraggiate a usare AppUserModelID espliciti.
Requisiti
| 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) |