Função MsiGetUserInfoA (msi.h)

Artigo
11/20/2024

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 encerramento.

[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 encerramento.

[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 encerramento.

Valor de retorno

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.

Observações

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 da empresa.

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Installer 5.0 no Windows Server 2012, Windows 8, Windows Server 2008 R2 ou Windows 7. Windows Installer 4.0 ou Windows Installer 4.5 no Windows Server 2008 ou Windows Vista. Windows Installer no Windows Server 2003 ou Windows XP. Consulte os Requisitos de Run-Time do Windows Installer para obter informações sobre o service pack mínimo do Windows exigido por uma versão do Windows Installer.
da Plataforma de Destino	Windows
cabeçalho	msi.h
biblioteca	Msi.lib
de DLL	Msi.dll

Consulte também

Funções de status do sistema

Compartilhar via