Funzione MsiEnumPatchesExA (msi.h)

La funzione MsiEnumPatchesEx enumera tutte le patch in un contesto specifico o in tutti i contesti. Le patch già applicate ai prodotti vengono enumerate. Vengono enumerate anche le patch registrate ma non ancora applicate ai prodotti.

Sintassi

UINT MsiEnumPatchesExA(
  [in, optional]      LPCSTR            szProductCode,
  [in, optional]      LPCSTR            szUserSid,
  [in]                DWORD             dwContext,
  [in]                DWORD             dwFilter,
  [in]                DWORD             dwIndex,
  [out, optional]     CHAR [39]         szPatchCode,
  [out, optional]     CHAR [39]         szTargetProductCode,
  [out, optional]     MSIINSTALLCONTEXT *pdwTargetProductContext,
  [out, optional]     LPSTR             szTargetUserSid,
  [in, out, optional] LPDWORD           pcchTargetUserSid
);

Parametri

[in, optional] szProductCode

Stringa con terminazione Null che specifica il GUID ProductCode del prodotto le cui patch sono enumerate. Se non NULL, l'enumerazione patch è limitata alle istanze di questo prodotto nell'utente e nel contesto specificato da szUserSid e dwContext. Se NULL, le patch per tutti i prodotti nel contesto specificato vengono enumerate.

[in, optional] szUserSid

Stringa con terminazione Null che specifica un ID di sicurezza (SID) che limita il contesto dell'enumerazione. La speciale stringa SID "S-1-1-0" (Everyone) specifica l'enumerazione in tutti gli utenti del sistema. Un valore SID diverso da "S-1-1-0" viene considerato un SID utente e limita l'enumerazione a tale utente. Quando si enumera per un utente diverso dall'utente corrente, le patch applicate in un contesto non gestito per utente usando una versione inferiore a Windows Installer versione 3.0 non vengono enumerate. Questo parametro può essere impostato su NULL per specificare l'utente corrente.

[in] dwContext

Limita l'enumerazione a una o a una combinazione di contesti. Questo parametro può essere uno o una combinazione dei valori seguenti.

[in] dwFilter

Filtro per l'enumerazione. Questo parametro può essere uno o una combinazione dei parametri seguenti.

[in] dwIndex

Indice della patch da recuperare. Questo parametro deve essere zero per la prima chiamata alla funzione MsiEnumPatchesEx e quindi incrementato per le chiamate successive. Il parametro dwIndex deve essere incrementato solo se la chiamata precedente ha restituito ERROR_SUCCESS.

[out, optional] szPatchCode

Buffer di output che contiene il GUID della patch da enumerare. Il buffer deve essere sufficientemente grande da contenere il GUID. Questo parametro può essere NULL.

[out, optional] szTargetProductCode

Buffer di output che contiene il GUID ProductCode del prodotto che riceve questa patch. Il buffer deve essere sufficientemente grande da contenere il GUID. Questo parametro può essere NULL.

[out, optional] pdwTargetProductContext

Restituisce il contesto della patch da enumerare. Il valore di output può essere MSIINSTALLCONTEXT_USERMANAGED, MSIINSTALLCONTEXT_USERUNMANAGED o MSIINSTALLCONTEXT_MACHINE. Questo parametro può essere NULL.

[out, optional] szTargetUserSid

Buffer di output che riceve il SID stringa dell'account in cui è presente questa istanza di patch. Questo buffer restituisce una stringa vuota per un contesto per computer.

Questo buffer deve essere sufficientemente grande da contenere il SID. Se il buffer è troppo piccolo, la funzione restituisce ERROR_MORE_DATA e imposta *pcchTargetUserSid sul numero di TCHAR nel valore, senza includere il carattere NULL di terminazione.

Se szTargetUserSid è impostato su NULL e pcchTargetUserSid è impostato su un puntatore valido, la funzione restituisce ERROR_SUCCESS e imposta *pcchTargetUserSid sul numero di TCHAR nel valore, senza includere il carattere NULL di terminazione. La funzione può quindi essere chiamata di nuovo per recuperare il valore, con buffer szTargetUserSid sufficientemente grande da contenere *pcchTargetUserSid + 1 caratteri.

Se szTargetUserSid e pcchTargetUserSid sono entrambi impostati su NULL, la funzione restituisce ERROR_SUCCESS se il valore esiste, senza recuperare il valore.

[in, out, optional] pcchTargetUserSid

Puntatore a una variabile che specifica il numero di TCHAR nel buffer szTargetUserSid . Quando la funzione viene restituita, questo parametro viene impostato sulle dimensioni del valore richiesto indipendentemente dal fatto che la funzione copia il valore nel buffer specificato. La dimensione viene restituita come numero di TCHAR nel valore richiesto, senza includere il carattere Null di terminazione.

Questo parametro può essere impostato su NULL solo se szTargetUserSid è null, altrimenti la funzione restituisce ERROR_INVALID_PARAMETER.

Valore restituito

La funzione MsiEnumPatchesEx restituisce uno dei valori seguenti.

Commenti

Gli amministratori non possono enumerare le patch solo all'interno della visibilità. Gli amministratori possono enumerare le patch per altri contesti utente.

Requisiti

Vedi anche

Contesto di installazione

MsiSourceListAddSourceEx

Non supportato in Windows Installer 2.0 e versioni precedenti

ProductCode