Função MsiNotifySidChangeW (msi.h)

Artigo
11/20/2024

A função MsiNotifySidChange notifica e atualiza as informações internas do Windows Installer com alterações nos SIDs do usuário.

Sintaxe

UINT MsiNotifySidChangeW(
  [in] LPCWSTR pOldSid,
  [in] LPCWSTR pNewSid
);

Parâmetros

[in] pOldSid

Cadeia de caracteres terminada em nulo que especifica o valor da cadeia de caracteres do SID (identificador de segurança) anterior.

[in] pNewSid

Cadeia de caracteres terminada em nulo que especifica o valor da cadeia de caracteres do novo SID (identificador de segurança).

Valor de retorno

Valor	Significado
ERROR_INVALID_PARAMETER	Um parâmetro inválido é passado para a função. Esse erro será retornado se algum dos parâmetros for NULL.
ERROR_SUCCESS	A função foi bem-sucedida.
ERROR_OUTOFMEMORY	Memória insuficiente estava disponível.
ERROR_FUNCTION_FAILED	Falha interna durante a execução.

Observações

Windows Installer 2.0 e Windows Installer 3.0: sem suporte. Essa função está disponível a partir do Windows Installer 3.1.

Nota

O cabeçalho msi.h define MsiNotifySidChange 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 3.1 no Windows Server 2003, Windows XP e Windows 2000. 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

sem suporte no Windows Installer 3.0 e anteriores

Compartilhar via