Funzione MsiGetUserInfoA (msi.h)

Articolo
11/20/2024

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 delle dimensioni complete 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 delle dimensioni complete 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
USERINFOSTATE_ABSENT	Alcune o tutte le informazioni utente sono assenti.
USERINFOSTATE_INVALIDARG	Uno dei parametri della funzione non è valido.
USERINFOSTATE_MOREDATA	Un buffer è troppo piccolo per contenere i dati richiesti.
USERINFOSTATE_PRESENT	La funzione è stata completata correttamente.
USERINFOSTATE_UNKNOWN	Il codice prodotto non identifica un prodotto noto.

Osservazioni

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 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. Per informazioni sul Service Pack minimo di Windows richiesto da una versione di Windows Installer, vedere Requisiti di windows Run-Time.
piattaforma di destinazione	Finestre
intestazione	msi.h
libreria	Msi.lib
dll	Msi.dll

Vedere anche

funzioni di stato del sistema

Condividi tramite