Função MsiGetUserInfoA (msi.h)

A função MsiGetUserInfo retorna as informações de usuário registradas para um produto instalado.

Sintaxe

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
);

Parâmetros

[in] szProduct

Especifica o código do produto para o produto a ser consultado.

[out] lpUserNameBuf

Ponteiro para uma variável que recebe o nome do usuário.

[in, out] pcchUserNameBuf

Ponteiro para uma variável que especifica o tamanho, em caracteres, do buffer apontado pelo parâmetro lpUserNameBuf . Esse tamanho deve incluir o caractere nulo de terminação.

[out] lpOrgNameBuf

Ponteiro para um buffer que recebe o nome da organização.

[in, out] pcchOrgNameBuf

Ponteiro para uma variável que especifica o tamanho, em caracteres, do buffer apontado pelo parâmetro lpOrgNameBuf . Na entrada, esse é o tamanho total do buffer, incluindo um espaço para um caractere nulo de terminação. Se o buffer passado for muito pequeno, a contagem retornada não incluirá o caractere nulo de terminação.

[in] lpSerialBuf

Ponteiro para um buffer que recebe a ID do produto.

[in, out] pcchSerialBuf

Ponteiro para uma variável que especifica o tamanho, em caracteres, do buffer apontado pelo parâmetro lpSerialBuf . Na entrada, esse é o tamanho total do buffer, incluindo um espaço para um caractere nulo de terminação. Se o buffer passado for muito pequeno, a contagem retornada não incluirá o caractere nulo de terminação.

Valor retornado

Valor	Significado
USERINFOSTATE_ABSENT	Algumas ou todas as informações do usuário estão ausentes.
USERINFOSTATE_INVALIDARG	Um dos parâmetros de função era inválido.
USERINFOSTATE_MOREDATA	Um buffer é muito pequeno para conter os dados solicitados.
USERINFOSTATE_PRESENT	A função foi concluída com êxito.
USERINFOSTATE_UNKNOWN	O código do produto não identifica um produto conhecido.

 

 

Comentários

Quando a função MsiGetUserInfo retorna, o parâmetro pcchNameBuf contém o comprimento da cadeia de caracteres de classe armazenada no buffer. A contagem retornada não inclui o caractere nulo de terminação. Se o buffer não for grande o suficiente, a função MsiGetUserInfo retornará USERINFOSTATE_MOREDATA e MsiGetUserInfo conterá o tamanho da cadeia de caracteres, em caracteres, sem contar o caractere nulo.

As informações do usuário são consideradas presentes mesmo na ausência de um nome de empresa.

Observação

O cabeçalho msi.h define MsiGetUserInfo como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Installer 5.0 no Windows Server 2012, no Windows 8, no Windows Server 2008 R2 ou no Windows 7. Windows Installer 4.0 ou Windows Installer 4.5 no Windows Server 2008 ou no Windows Vista. Windows Installer no Windows Server 2003 ou no Windows XP. Confira os Requisitos de tempo de execução do Windows Installer para obter informações sobre o service pack mínimo do Windows exigido por uma versão do Windows Installer.
Plataforma de Destino	Windows
Cabeçalho	msi.h
Biblioteca	Msi.lib
DLL	Msi.dll

Confira também

Funções de status do sistema