Funzione MsiGetUserInfoA (msi.h)
La funzione MsiGetUserInfo restituisce le informazioni utente registrate per un prodotto installato.
Sintassi
USERINFOSTATE MsiGetUserInfoA(
[in] LPCSTR szProduct,
[out] LPSTR lpUserNameBuf,
[in, out] LPDWORD pcchUserNameBuf,
[out] LPSTR lpOrgNameBuf,
[in, out] LPDWORD pcchOrgNameBuf,
[in] LPSTR lpSerialBuf,
[in, out] LPDWORD pcchSerialBuf
);
Parametri
[in] szProduct
Specifica il codice prodotto per il prodotto su cui eseguire una query.
[out] lpUserNameBuf
Puntatore a una variabile che riceve il nome dell'utente.
[in, out] pcchUserNameBuf
Puntatore a una variabile che specifica le dimensioni, in caratteri, del buffer a cui punta il parametro lpUserNameBuf . Questa dimensione deve includere il carattere Null di terminazione.
[out] lpOrgNameBuf
Puntatore a un buffer che riceve il nome dell'organizzazione.
[in, out] pcchOrgNameBuf
Puntatore a una variabile che specifica le dimensioni, in caratteri, del buffer a cui punta il parametro lpOrgNameBuf . 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.
[in] lpSerialBuf
Puntatore a un buffer che riceve l'ID prodotto.
[in, out] pcchSerialBuf
Puntatore a una variabile che specifica le dimensioni, in caratteri, del buffer a cui punta il parametro lpSerialBuf . 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.
Valore restituito
| Valore | Significato |
|---|---|
|
Alcune o tutte le informazioni utente sono assenti. |
|
Uno dei parametri della funzione non è valido. |
|
Un buffer è troppo piccolo per contenere i dati richiesti. |
|
La funzione è stata completata correttamente. |
|
Il codice prodotto non identifica un prodotto noto. |
Commenti
Quando viene restituita la funzione MsiGetUserInfo , il parametro pcchNameBuf contiene la lunghezza della stringa di classe archiviata nel buffer. Il conteggio restituito non include il carattere Null di terminazione. Se il buffer non è sufficientemente grande, la funzione MsiGetUserInfo restituisce USERINFOSTATE_MOREDATA e MsiGetUserInfo contiene le dimensioni della stringa, in caratteri, senza contare il carattere Null.
Le informazioni utente sono considerate presenti anche in assenza di un nome aziendale.
Nota
L'intestazione msi.h definisce MsiGetUserInfo 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
| 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. 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 |