Condividi tramite


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