Funzione MsiProvideQualifiedComponentW (msi.h)
La funzione MsiProvideQualifiedComponent restituisce il percorso completo del componente per un componente qualificato ed esegue qualsiasi installazione necessaria. Questa funzione richiede l'origine, se necessario, e incrementa il numero di utilizzo per la funzionalità.
Sintassi
UINT MsiProvideQualifiedComponentW(
[in] LPCWSTR szCategory,
[in] LPCWSTR szQualifier,
[in] DWORD dwInstallMode,
[out] LPWSTR lpPathBuf,
[in, out] LPDWORD pcchPathBuf
);
Parametri
[in] szCategory
Specifica l'ID componente per il componente richiesto. Questo potrebbe non essere il GUID per il componente stesso, ma piuttosto un server che fornisce la funzionalità corretta, come nella colonna ComponentId della tabella PublishComponent.
[in] szQualifier
Specifica un qualificatore in un elenco di componenti pubblicitari (da PublishComponent Table).
[in] dwInstallMode
Definisce la modalità di installazione. Questo parametro può avere uno dei valori seguenti.
| Valore | Significato |
|---|---|
|
Specificare il componente ed eseguire qualsiasi installazione necessaria per fornire il componente. Se manca il file chiave di un componente nella funzionalità richiesta o un elemento padre della funzionalità, reinstallare la funzionalità usando MsiReinstallFeature con i flag seguenti impostati: REINSTALLMODE_FILEMISSING, REINSTALLMODE_FILEOLDERVERSION, REINSTALLMODE_FILEVERIFY, REINSTALLMODE_MACHINEDATA, REINSTALLMODE_USERDATA e REINSTALLMODE_SHORTCUT. |
|
Specificare il componente solo se la funzionalità esiste. In caso contrario, restituire ERROR_FILE_NOT_FOUND.
Questa modalità verifica che il file di chiave del componente esista. |
|
Specificare il componente solo se la funzionalità esiste. In caso contrario, restituire ERROR_FILE_NOT_FOUND.
Questa modalità controlla solo che il componente sia registrato e non verifichi che il file di chiave del componente esista. |
|
Chiamare MsiReinstallFeature per reinstallare la funzionalità usando questo parametro per il parametro dwReinstallMode e quindi specificare il componente. |
|
Specificare il componente solo se lo stato di installazione della funzionalità è INSTALLSTATE_LOCAL. Se lo stato di installazione della funzionalità è INSTALLSTATE_SOURCE, restituire ERROR_INSTALL_SOURCE_ABSENT. In caso contrario, restituisce ERROR_FILE_NOT_FOUND. Questa modalità controlla solo che il componente sia registrato e non verifichi che il file di chiave esista. |
[out] lpPathBuf
Puntatore a una variabile che riceve il percorso del componente. Questo parametro può essere null.
[in, out] pcchPathBuf
Puntatore a una variabile che specifica le dimensioni, in caratteri, del buffer a cui punta il parametro lpPathBuf . Nell'input si tratta della dimensione completa del buffer, incluso uno spazio per un carattere Null di terminazione. Se il buffer passato è troppo piccolo, il conteggio restituito non include il carattere Null di terminazione.
Se lpPathBuf è null, pcchBuf può essere null.
Valore restituito
| Valore | Significato |
|---|---|
|
Il qualificatore del componente non è valido o assente. |
|
La funzione è stata completata correttamente. |
|
La funzionalità è assente o interrotta. Questo errore viene restituito per dwInstallMode = INSTALLMODE_EXISTING. |
|
Il componente specificato è sconosciuto. |
|
Vedere Codici di errore. |
| Si è verificato un errore relativo all'inizializzazione. |
Commenti
Dopo l'esito positivo della funzione MsiProvideQualifiedComponent , il parametro pcchPathBuf contiene la lunghezza della stringa in lpPathBuf.
Le funzionalità con componenti contenenti un file danneggiato o la versione errata di un file devono essere reinstallate in modo esplicito dall'utente o tramite la chiamata dell'applicazione MsiReinstallFeature.
Nota
L'intestazione msi.h definisce MsiProvideQualifiedComponent 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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.
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 Windows Installer Run-Time Requirements .See the Windows Installer requirements for information about the minimum Windows Service Pack that is required by a Windows Installer version. |
| Piattaforma di destinazione | Windows |
| Intestazione | msi.h |
| Libreria | Msi.lib |
| DLL | Msi.dll |
Vedi anche
Funzioni specifiche dei componenti