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