Funzione MsiSetTargetPathA (msiquery.h)

Articolo
11/20/2024

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, MsiOpenPackageExo 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 con un separatore di directory.

Valore restituito

La funzione MsiSetTargetPath restituisce i valori seguenti:

Osservazioni

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 nella tabella subordinati o equivalenti al percorso modificato vengono aggiornate in modo da 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 ripristinano i valori precedenti. Pertanto, è sicuro trattare gli errori restituiti da questa funzione come non irreversibili.

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 non riesce, è possibile ottenere informazioni estese sull'errore 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 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
piattaforma di destinazione	Finestre
intestazione	msiquery.h
libreria	Msi.lib
dll	Msi.dll

Vedere anche

Funzioni di posizione del programma di installazione

Condividi tramite