Funzione MsiGetShortcutTargetA (msi.h)
La funzione MsiGetShortcutTarget esamina un collegamento e restituisce il prodotto, il nome della funzionalità e il componente, se disponibili.
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 avere una lunghezza di 39 caratteri. I primi 38 caratteri sono relativi al GUID e l'ultimo carattere è per il carattere Null di terminazione. Questo parametro può essere Null.
[out] szFeatureId
Nome della funzionalità del collegamento. Il buffer di stringa deve essere lungo MAX_FEATURE_CHARS+1 caratteri. Questo parametro può essere Null.
[out] szComponentCode
GUID del codice del componente. Questo buffer di stringa deve avere una lunghezza di 39 caratteri. I primi 38 caratteri sono relativi al GUID e l'ultimo carattere è per il carattere Null di terminazione. Questo parametro può essere Null.
Valore restituito
Questa funzione restituisce UINT.
Osservazioni
Se la funzione ha esito negativo e il collegamento esiste, è possibile accedere al normale contenuto 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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.
Fabbisogno
Requisito | Valore |
---|---|
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 Requisiti di windows Run-Time. |
piattaforma di destinazione | Finestre |
intestazione |
msi.h |
libreria |
Msi.lib |
dll | Msi.dll |