Metodo IApplicationDestinations::SetAppID (shobjidl_core.h)
Specifica un ID modello utente dell'applicazione univoco (AppUserModelID) per l'applicazione dalla quale il pulsante Jump List del pulsante della barra delle applicazioni rimuoverà le destinazioni. È 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 RemoveAllDestinations o RemoveDestination.
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 vengono chiamati IApplicationDestinations::RemoveDestination o IApplicationDestinations::RemoveAllDestinations . Tuttavia, esiste un vantaggio per le prestazioni per evitare tali calcoli, in modo che le applicazioni che forniscono jump Elenchi personalizzate siano 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) |