Funzione MsiSetTargetPathA (msiquery.h)

La funzione MsiSetTargetPath imposta il percorso di destinazione completo per una cartella nella tabella Directory.

Sintassi

UINT MsiSetTargetPathA(
  [in] MSIHANDLE hInstall,
  [in] LPCSTR    szFolder,
  [in] LPCSTR    szFolderPath
);

Parametri

[in] hInstall

Gestire l'installazione fornita a un'azione personalizzata DLL o ottenuta tramite MsiOpenPackage, MsiOpenPackageEx o MsiOpenProduct.

[in] szFolder

Specifica l'identificatore della cartella. Si tratta di una chiave primaria nella tabella Directory.

[in] szFolderPath

Specifica il percorso completo per la cartella, terminando in un separatore di directory.

Valore restituito

La funzione MsiSetTargetPath restituisce i valori seguenti:

Commenti

La funzione MsiSetTargetPath modifica la specifica del percorso per la directory di destinazione denominata nella tabella Directory in memoria. Inoltre, le specifiche del percorso di tutti gli altri oggetti percorso della tabella che sono subordinati o equivalenti al percorso modificato vengono aggiornate per riflettere la modifica. Vengono aggiornate anche le proprietà per ogni percorso interessato.

MsiSetTargetPath ha esito negativo se la directory selezionata è di sola lettura.

Se si verifica un errore in questa funzione, tutti i percorsi e le proprietà aggiornati vengono ripristinati nei valori precedenti. Pertanto, è sicuro trattare gli errori restituiti da questa funzione come non irreversibile.

Non tentare di configurare il percorso di destinazione se i componenti che usano tali percorsi sono già installati per l'utente corrente o per un utente diverso. Controllare la proprietà ProductState prima di chiamare MsiSetTargetPath per determinare se il prodotto contenente questo componente è installato.

Vedere Chiamata di funzioni di database da programmi.

Se la funzione ha esito negativo, è possibile ottenere informazioni di errore estese usando MsiGetLastErrorRecord.

Nota

L'intestazione msiquery.h definisce MsiSetTargetPath 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

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
Piattaforma di destinazione	Windows
Intestazione	msiquery.h
Libreria	Msi.lib
DLL	Msi.dll

Vedi anche

Funzioni percorso del programma di installazione