MsiNotifySidChangeA-Funktion (msi.h)

  • Artikel

Die MsiNotifySidChange-Funktion benachrichtigt und aktualisiert die internen Windows Installer-Informationen mit Änderungen an Benutzer-SIDs.

Syntax

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

Parameter

[in] pOldSid

Null-beendete Zeichenfolge, die den Zeichenfolgenwert des vorherigen Sicherheitsbezeichners (SID) angibt.

[in] pNewSid

Null-beendete Zeichenfolge, die den Zeichenfolgenwert des neuen Sicherheitsbezeichners (SID) angibt.

Rückgabewert

Wert Bedeutung
ERROR_INVALID_PARAMETER
 Ein ungültiger Parameter wird an die Funktion übergeben. Dieser Fehler wird zurückgegeben, wenn einer der Parameter NULL ist.
ERROR_SUCCESS
 Die Funktion wurde erfolgreich ausgeführt.
ERROR_OUTOFMEMORY
 Nicht genügend Arbeitsspeicher war verfügbar.
ERROR_FUNCTION_FAILED
 Interner Fehler während der Ausführung.

Hinweise

Windows Installer 2.0 und Windows Installer 3.0: Nicht unterstützt. Diese Funktion ist ab Windows Installer 3.1 verfügbar.

Hinweis

Der msi.h-Header definiert MsiNotifySidChange als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Installer 5.0 unter Windows Server 2012, Windows 8, Windows Server 2008 R2 oder Windows 7. Windows Installer 4.0 oder Windows Installer 4.5 unter Windows Server 2008 oder Windows Vista. Windows Installer 3.1 unter Windows Server 2003, Windows XP und Windows 2000. Informationen zum mindestens erforderlichen Windows Service Pack für eine Windows Installer-Version finden Sie unter Windows Installer – Laufzeitanforderungen.
Zielplattform Windows
Kopfzeile msi.h
Bibliothek Msi.lib
DLL Msi.dll

Weitere Informationen

Nicht von Windows Installer 3.0 und früher unterstützt