Condividi tramite

Enumerazione ASSOCSTR (shlwapi.h)

  • Articolo

Usato da IQueryAssociations::GetString per definire il tipo di stringa da restituire.

Sintassi

typedef enum {
  ASSOCSTR_COMMAND = 1,
  ASSOCSTR_EXECUTABLE,
  ASSOCSTR_FRIENDLYDOCNAME,
  ASSOCSTR_FRIENDLYAPPNAME,
  ASSOCSTR_NOOPEN,
  ASSOCSTR_SHELLNEWVALUE,
  ASSOCSTR_DDECOMMAND,
  ASSOCSTR_DDEIFEXEC,
  ASSOCSTR_DDEAPPLICATION,
  ASSOCSTR_DDETOPIC,
  ASSOCSTR_INFOTIP,
  ASSOCSTR_QUICKTIP,
  ASSOCSTR_TILEINFO,
  ASSOCSTR_CONTENTTYPE,
  ASSOCSTR_DEFAULTICON,
  ASSOCSTR_SHELLEXTENSION,
  ASSOCSTR_DROPTARGET,
  ASSOCSTR_DELEGATEEXECUTE,
  ASSOCSTR_SUPPORTED_URI_PROTOCOLS,
  ASSOCSTR_PROGID,
  ASSOCSTR_APPID,
  ASSOCSTR_APPPUBLISHER,
  ASSOCSTR_APPICONREFERENCE,
  ASSOCSTR_MAX
} ASSOCSTR;

Costanti

 
ASSOCSTR_COMMAND
Valore: 1
Stringa di comando associata a un verbo shell.
ASSOCSTR_EXECUTABLE
Eseguibile da una stringa di comando verbo shell. Ad esempio, questa stringa viene trovata come valore (predefinito) per una sottochiave, ad esempio

HKEY_CLASSES_ROOT\Applicationname\Guscio\Aperto\comando. Se il comando usa Rundll.exe, impostare il flag ASSOCF_REMAPRUNDLL nel parametro flags di IQueryAssociations::GetString per recuperare l'eseguibile di destinazione.

Attenzione  

Non tutte le associazioni di app hanno file eseguibili. Non presupporre che un eseguibile sia sempre presente.


 

Questo tipo di stringa identificherà il codice che verrà richiamato nell'implementazione del verbo.
ASSOCSTR_FRIENDLYDOCNAME
Nome descrittivo di un tipo di documento.
ASSOCSTR_FRIENDLYAPPNAME
Nome descrittivo di un file eseguibile.
ASSOCSTR_NOOPEN
Ignorare le informazioni associate alla sottochiave aperta .
ASSOCSTR_SHELLNEWVALUE
Cercare sotto la sottochiave ShellNew .
ASSOCSTR_DDECOMMAND
Modello per i comandi DDE.
ASSOCSTR_DDEIFEXEC
Comando DDE da usare per creare un processo.
ASSOCSTR_DDEAPPLICATION
Nome dell'applicazione in una trasmissione DDE.
ASSOCSTR_DDETOPIC
Nome dell'argomento in una trasmissione DDE.
ASSOCSTR_INFOTIP
Corrisponde al valore del Registro di sistema InfoTip. Restituisce un suggerimento per informazioni per un elemento o un elenco di proprietà sotto forma di IPropertyDescriptionList da cui creare una descrizione informativa, ad esempio quando si passa il cursore su un nome file. L'elenco delle proprietà può essere analizzato con PSGetPropertyDescriptionListFromString.
ASSOCSTR_QUICKTIP
Introdotto in Internet Explorer 6. Corrisponde al valore del Registro di sistema Descrizione rapida. Uguale a ASSOCSTR_INFOTIP, ad eccezione del fatto che restituisce sempre un elenco di nomi di proprietà sotto forma di IPropertyDescriptionList. La differenza tra questo valore e ASSOCSTR_INFOTIP è che restituisce proprietà sicure per qualsiasi scenario che causa un rallentamento del recupero delle proprietà, ad esempio reti offline o lente. Alcune delle proprietà restituite da ASSOCSTR_INFOTIP potrebbero non essere appropriate per scenari di recupero lento delle proprietà. L'elenco delle proprietà può essere analizzato con PSGetPropertyDescriptionListFromString.
ASSOCSTR_TILEINFO
Introdotto in Internet Explorer 6. Corrisponde al valore del Registro di sistema TileInfo. Contiene un elenco di proprietà da visualizzare per un particolare tipo di file in una finestra di Esplora risorse presente nella visualizzazione riquadro. Equivale a ASSOCSTR_INFOTIP, ma, come ASSOCSTR_QUICKTIP, restituisce anche un elenco di nomi di proprietà sotto forma di IPropertyDescriptionList. L'elenco delle proprietà può essere analizzato con PSGetPropertyDescriptionListFromString.
ASSOCSTR_CONTENTTYPE
Introdotto in Internet Explorer 6. Descrive un tipo generale di associazione di file MIME, ad esempio image e bmp, in modo che le applicazioni possano fare ipotesi generali su un tipo di file specifico.
ASSOCSTR_DEFAULTICON
Introdotto in Internet Explorer 6. Restituisce il percorso delle risorse dell'icona da utilizzare per impostazione predefinita per questa associazione. I numeri positivi indicano un indice nella tabella delle risorse della DLL, mentre i numeri negativi indicano un ID risorsa. Un esempio della sintassi per la risorsa è "c:\myfolder\myfile.dll,-1".
ASSOCSTR_SHELLEXTENSION
Introdotto in Internet Explorer 6. Per un oggetto a cui è associata un'estensione shell, è possibile usarlo per recuperare il CLSID dell'oggetto estensione shell passando una rappresentazione di stringa dell'IID dell'interfaccia che si desidera recuperare come parametro pwszExtra di IQueryAssociations::GetString. Ad esempio, se si vuole recuperare un gestore che implementa l'interfaccia IExtractImage , specificare "{BB2E617C-0920-11d1-9A0B-00C04FC2D6C1}", ovvero l'IID di IExtractImage.
ASSOCSTR_DROPTARGET
Introdotto in Internet Explorer 8. Per un verbo richiamato tramite COM e l'interfaccia IDropTarget , è possibile utilizzare questo flag per recuperare il CLSID dell'oggetto IDropTarget . Questo CLSID viene registrato nella sottochiave DropTarget . Il verbo viene specificato nel parametro pwszExtra nella chiamata a IQueryAssociations::GetString.

Questo tipo di stringa identificherà il codice che verrà richiamato nell'implementazione del verbo.
ASSOCSTR_DELEGATEEXECUTE
Introdotto in Internet Explorer 8. Per un verbo richiamato tramite COM e l'interfaccia IExecuteCommand , è possibile usare questo flag per recuperare il CLSID dell'oggetto IExecuteCommand . Questo CLSID viene registrato nella sottochiave del comando del verbo come voce DelegateExecute. Il verbo viene specificato nel parametro pwszExtra nella chiamata a IQueryAssociations::GetString.

Questo tipo di stringa identificherà il codice che verrà richiamato nell'implementazione del verbo.
ASSOCSTR_SUPPORTED_URI_PROTOCOLS
Valore stringa degli schemi del protocollo URI. Ad esempio, http:https:ftp:file: o * che indica tutto.
ASSOCSTR_PROGID
Introdotta in Windows 10. ProgID fornito dall'app associata al tipo di file o allo schema URI. Questa impostazione se configurata dagli utenti nelle impostazioni predefinite del programma.
ASSOCSTR_APPID
Introdotta in Windows 10. AppUserModelID dell'app associata al tipo di file o allo schema URI. Questa impostazione viene configurata dagli utenti nelle impostazioni predefinite del programma.
ASSOCSTR_APPPUBLISHER
Introdotta in Windows 10. Autore dell'app associata al tipo di file o allo schema URI. Questa impostazione viene configurata dagli utenti nelle impostazioni predefinite del programma.
ASSOCSTR_APPICONREFERENCE
Introdotta in Windows 10. Riferimento icona dell'app associata al tipo di file o allo schema URI. Questa impostazione viene configurata dagli utenti nelle impostazioni predefinite del programma.
ASSOCSTR_MAX
Valore ASSOCSTR definito massimo, usato a scopo di convalida.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional, Windows XP, Windows 7 [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Intestazione shlwapi.h