Funzione MsiEnumClientsExA (msi.h)

La funzione MsiEnumClientsEx enumera le applicazioni installate che usano un componente specificato. La funzione recupera un codice prodotto per un'applicazione ogni volta che viene chiamata.

Windows Installer 4.5 o versioni precedenti: Non supportato. Questa funzione è disponibile a partire da Windows Installer 5.0.

Sintassi

UINT MsiEnumClientsExA(
  [in]                LPCSTR            szComponent,
  [in, optional]      LPCSTR            szUserSid,
  [in]                DWORD             dwContext,
  [in]                DWORD             dwProductIndex,
  [out, optional]     CHAR [39]         szProductBuf,
  [out, optional]     MSIINSTALLCONTEXT *pdwInstalledContext,
  [out, optional]     LPSTR             szSid,
  [in, out, optional] LPDWORD           pcchSid
);

Parametri

[in] szComponent

GUID del codice del componente che identifica il componente. La funzione enumera le applicazioni che usano questo componente.

[in, optional] szUserSid

Valore stringa con terminazione null contenente un identificatore di sicurezza (SID). L'enumerazione delle applicazioni si estende agli utenti identificati da questo SID. La stringa SID speciale s-1-1-0 (Tutti) enumera tutte le applicazioni per tutti gli utenti del sistema. Un valore SID diverso da s-1-1-0 specifica un SID utente per un utente specifico ed enumera le istanze di applicazioni installate dall'utente specificato.

[in] dwContext

Flag che estende l'enumerazione alle istanze di applicazioni installate nel contesto di installazione specificato. L'enumerazione include solo istanze di applicazioni installate dagli utenti identificati da szUserSid.

Questa può essere una combinazione dei valori seguenti.

[in] dwProductIndex

Specifica l'indice dell'applicazione da recuperare. Il valore di questo parametro deve essere zero (0) nella prima chiamata alla funzione. Per ogni chiamata successiva, l'indice deve essere incrementato di 1. L'indice deve essere incrementato solo se la chiamata precedente alla funzione restituisce ERROR_SUCCESS.

[out, optional] szProductBuf

Valore stringa che riceve il codice prodotto per l'applicazione. La lunghezza del buffer in questa posizione deve essere sufficiente per contenere un valore stringa con terminazione null contenente il codice prodotto. I primi 38 caratteri TCHAR ricevono il GUID per il componente e il 39° carattere riceve un carattere NULL terminante.

[out, optional] pdwInstalledContext

Flag che fornisce il contesto di installazione dell'applicazione.

Questa può essere una combinazione dei valori seguenti.

[out, optional] szSid

Riceve l'identificatore di sicurezza (SID) che identifica l'utente che ha installato l'applicazione. Il percorso riceve un valore stringa vuoto se questa istanza dell'applicazione esiste in un contesto di installazione per computer.

La lunghezza del buffer deve essere abbastanza grande per contenere un valore stringa con terminazione null contenente il SID. Se il buffer è troppo piccolo, la funzione restituisce ERROR_MORE_DATA e la posizione puntata da pcchSid riceve il numero di TCHAR nel SID, non incluso il carattere NULL terminante.

Se szSid è impostato su NULL e pcchSid è un puntatore valido a una posizione in memoria, la funzione restituisce ERROR_SUCCESS e la posizione riceve il numero di TCHAR nel SID, non incluso il carattere null terminante. La funzione può quindi essere chiamata di nuovo per recuperare il valore, con il buffer szSid ridimensionato abbastanza grande per contenere *pcchSid + 1 caratteri.

[in, out, optional] pcchSid

Puntatore a una posizione in memoria contenente una variabile che specifica il numero di TCHAR nel SID, non incluso il carattere Null terminante. Quando la funzione restituisce, questa variabile viene impostata sulle dimensioni del SID richiesto se la funzione può copiare correttamente il SID e terminare il carattere Null nella posizione del buffer a cui punta szSid. La dimensione viene restituita come numero di TCHAR nel valore richiesto, non incluso il carattere Null terminante.

Questo parametro può essere impostato su NULL solo se szSid è null, altrimenti la funzione restituisce ERROR_INVALID_PARAMETER. Se szSid e pcchSid sono entrambi impostati su NULL, la funzione restituisce ERROR_SUCCESS se il SID esiste, senza recuperare il valore SID.

Valore restituito

La funzione MsiEnumClientsEx restituisce uno dei valori seguenti.

Commenti

Requisiti