Metodo IApplicationAssociationRegistration::QueryCurrentDefault (shobjidl_core.h)

Determina l'applicazione predefinita per un determinato tipo di associazione. Si tratta dell'applicazione predefinita avviata da ShellExecute per quel tipo.

Sintassi

HRESULT QueryCurrentDefault(
  [in]  LPCWSTR          pszQuery,
  [in]  ASSOCIATIONTYPE  atQueryType,
  [in]  ASSOCIATIONLEVEL alQueryLevel,
  [out] LPWSTR           *ppszAssociation
);

Parametri

[in] pszQuery

Tipo: LPCWSTR

Puntatore a una stringa Unicode con terminazione Null contenente l'estensione o il protocollo del nome file, ad esempio .mp3 o http.

[in] atQueryType

Tipo: ASSOCIATIONTYPE

Uno dei valori di enumerazione ASSOCIATIONTYPE che specifica il tipo di associazione, ad esempio estensione o tipo MIME.

[in] alQueryLevel

Tipo: ASSOCIATIONLEVEL

Uno dei valori di enumerazione ASSOCIATIONLEVEL che specifica il livello di associazione, ad esempio per utente o computer. Si tratta in genere di AL_EFFECTIVE.

[out] ppszAssociation

Tipo: LPWSTR*

Quando termina, questo metodo contiene l'indirizzo di un puntatore al ProgID che identifica l'associazione predefinita corrente.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

La stringa prodotta è in genere un ProgID corrispondente a uno dei ProgID associati a un'applicazione registrata, ma esistono alcune eccezioni: se la stringa restituita è un protocollo predefinito del computer, si tratta di una stringa legacy che indica una riga di comando a un gestore .exe invece di un ProgID. Analogamente, se restituisce un tipo MIME predefinito del computer, restituisce una stringa CLSID (Legacy Class Identifier) anziché progID.

Requisiti

Vedi anche

Programmi predefiniti

IApplicationAssociationRegistration