Funzione MsiGetShortcutTargetA (msi.h)
La funzione MsiGetShortcutTarget esamina un collegamento e restituisce il relativo prodotto, il nome della funzionalità e il componente, se disponibile.
Sintassi
UINT MsiGetShortcutTargetA(
[in] LPCSTR szShortcutPath,
[out] LPSTR szProductCode,
[out] LPSTR szFeatureId,
[out] LPSTR szComponentCode
);
Parametri
[in] szShortcutPath
Stringa con terminazione null che specifica il percorso completo di un collegamento.
[out] szProductCode
GUID per il codice prodotto del collegamento. Questo buffer di stringa deve essere lungo 39 caratteri. I primi 38 caratteri sono per il GUID e l'ultimo carattere è per il carattere null terminante. Questo parametro può essere null.
[out] szFeatureId
Nome della funzionalità del collegamento. Il buffer stringa deve essere MAX_FEATURE_CHARS+1 caratteri lunghi. Questo parametro può essere null.
[out] szComponentCode
GUID del codice del componente. Questo buffer di stringa deve essere lungo 39 caratteri. I primi 38 caratteri sono per il GUID e l'ultimo carattere è per il carattere null terminante. Questo parametro può essere null.
Valore restituito
Questa funzione restituisce UINT.
Commenti
Se la funzione ha esito negativo e il collegamento esiste, è possibile accedere al contenuto regolare del collegamento tramite l'interfaccia IShellLink .
In caso contrario, lo stato della destinazione può essere determinato usando le funzioni di selezione del programma di installazione.
Nota
L'intestazione msi.h definisce MsiGetShortcutTarget come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
Requisiti
Client minimo supportato | Windows Installer 5.0 in Windows Server 2012, Windows 8, Windows Server 2008 R2 o Windows 7. Windows Installer 4.0 o Windows Installer 4.5 in Windows Server 2008 o Windows Vista. Windows Installer in Windows Server 2003 o Windows XP. Per informazioni sul Service Pack minimo di Windows Richiesto da una versione di Windows Installer, vedere i requisiti di Windows Installer Run-Time. |
Piattaforma di destinazione | Windows |
Intestazione | msi.h |
Libreria | Msi.lib |
DLL | Msi.dll |