Metodo IApplicationDocumentLists::SetAppID (shobjidl_core.h)

  • Articolo

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)

Vedi anche

ID modello utente applicazione (AppUserModelIDs)

IApplicationDocumentLists

Estensioni della barra delle applicazioni