Função MsiGetUserInfoW (msi.h)

  • Artigo

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

Sintaxe

USERINFOSTATE MsiGetUserInfoW(
  [in]      LPCWSTR szProduct,
  [out]     LPWSTR  lpUserNameBuf,
  [in, out] LPDWORD pcchUserNameBuf,
  [out]     LPWSTR  lpOrgNameBuf,
  [in, out] LPDWORD pcchOrgNameBuf,
  [in]      LPWSTR  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 armazenar 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

   
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