MsiNotifySidChangeA function (msi.h)

The MsiNotifySidChange function notifies and updates the Windows Installer internal information with changes to user SIDs.

Syntax

UINT MsiNotifySidChangeA(
  [in] LPCSTR pOldSid,
  [in] LPCSTR pNewSid
);

Parameters

[in] pOldSid

Null-terminated string that specifies the string value of the previous security identifier(SID).

[in] pNewSid

Null-terminated string that specifies the string value of the new security identifier(SID).

Return value

Value Meaning
ERROR_INVALID_PARAMETER
An invalid parameter is passed to the function. This error returned if any of the parameters is NULL.
ERROR_SUCCESS
The function succeeded.
ERROR_OUTOFMEMORY
Insufficient memory was available.
ERROR_FUNCTION_FAILED
Internal failure during execution.

Remarks

Windows Installer 2.0 and Windows Installer 3.0:  Not supported. This function is available beginning with Windows Installer 3.1.

Note

The msi.h header defines MsiNotifySidChange as an alias which automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.

Requirements

Requirement Value
Minimum supported client Windows Installer 5.0 on Windows Server 2012, Windows 8, Windows Server 2008 R2 or Windows 7. Windows Installer 4.0 or Windows Installer 4.5 on Windows Server 2008 or Windows Vista. Windows Installer 3.1 on Windows Server 2003, Windows XP, and Windows 2000. See the Windows Installer Run-Time Requirements for information about the minimum Windows service pack that is required by a Windows Installer version.
Target Platform Windows
Header msi.h
Library Msi.lib
DLL Msi.dll

See also

Not Supported in Windows Installer 3.0 and earlier