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 |
|---|---|
|
An invalid parameter is passed to the function. This error returned if any of the parameters is NULL. |
|
The function succeeded. |
|
Insufficient memory was available. |
|
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 that 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 is 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 |