Metodo IQueryInfo::GetInfoTip (shlobj_core.h)

Ottiene il testo della descrizione informativa per un elemento.

Sintassi

HRESULT GetInfoTip(
        DWORD dwFlags,
  [out] PWSTR *ppwszTip
);

Parametri

dwFlags

Tipo: DWORD

Flag che indirizzano la gestione dell'elemento da cui si sta recuperando il testo del suggerimento per le informazioni. Questo valore è in genere zero (QITIPF_DEFAULT). Vengono riconosciuti i valori seguenti.

QITIPF_DEFAULT (0x00000000)

Nessuna gestione speciale.

QITIPF_USENAME (0x00000001)

Specificare il nome dell'elemento in ppwszTip anziché il testo della descrizione informativa.

QITIPF_LINKNOTARGET (0x00000002)

Se l'elemento è un collegamento, recuperare il testo della descrizione informativa del collegamento anziché la destinazione.

QITIPF_LINKUSETARGET (0x00000004)

Se l'elemento è un collegamento, recuperare il testo della descrizione informativa della destinazione del collegamento.

QITIPF_USESLOWTIP (0x00000008)

Cercare le informazioni nell'intero spazio dei nomi. Questo valore può comportare un tempo di risposta ritardato.

QITIPF_SINGLELINE (0x00000010)

Windows Vista e versioni successive. Inserire la descrizione informativa su una singola riga.

[out] ppwszTip

Tipo: PWSTR*

L'indirizzo di un puntatore di stringa Unicode che, quando questo metodo viene restituito correttamente, riceve il puntatore della stringa della mancia. Le applicazioni che implementano questo metodo devono allocare memoria per ppwszTip chiamando CoTaskMemAlloc. Le applicazioni chiamante devono chiamare CoTaskMemFree per liberare la memoria quando non è più necessaria.

Valore restituito

Tipo: HRESULT

Restituisce S_OK se la funzione ha esito positivo. Se non è disponibile alcun testo di suggerimento informazioni, ppwszTip è impostato su NULL. In caso contrario, restituisce un valore di errore definito da COM.

Requisiti

Vedi anche

IQueryInfo