Metodo IApplicationDestinations::SetAppID (shobjidl_core.h)

  • Articolo

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)

Vedi anche

ID modello utente applicazione (AppUserModelIDs)

IApplicationDestinations

Estensioni della barra delle applicazioni