NOTIFYICONDATAA-Struktur (shellapi.h)

Enthält Informationen, die das System zum Anzeigen von Benachrichtigungen im Benachrichtigungsbereich benötigt. Wird von Shell_NotifyIcon verwendet.

Syntax

typedef struct _NOTIFYICONDATAA {
  DWORD cbSize;
  HWND  hWnd;
  UINT  uID;
  UINT  uFlags;
  UINT  uCallbackMessage;
  HICON hIcon;
#if ...
  CHAR  szTip[64];
#else
  CHAR  szTip[128];
#endif
  DWORD dwState;
  DWORD dwStateMask;
  CHAR  szInfo[256];
  union {
    UINT uTimeout;
    UINT uVersion;
  } DUMMYUNIONNAME;
  CHAR  szInfoTitle[64];
  DWORD dwInfoFlags;
  GUID  guidItem;
  HICON hBalloonIcon;
} NOTIFYICONDATAA, *PNOTIFYICONDATAA;

Member

cbSize

Art: DWORD

Die Größe dieser Struktur in Bytes.

hWnd

Typ: HWND

Ein Handle zum Fenster, das Benachrichtigungen empfängt, die einem Symbol im Benachrichtigungsbereich zugeordnet sind.

uID

Typ: UINT

Der anwendungsdefinierte Bezeichner des Taskleistensymbols. Die Shell verwendet entweder (hWnd plus uID) oder guidItem , um zu identifizieren, welches Symbol ausgeführt werden soll, wenn Shell_NotifyIcon aufgerufen wird. Sie können mehrere Symbole mit einem einzelnen hWnd verknüpft haben, indem Sie jedem eine andere uID zuweisen. Wenn guidItem angegeben wird, wird uID ignoriert.

uFlags

Typ: UINT

Flags, die entweder angeben, welche der anderen Elemente der Struktur gültige Daten enthalten oder zusätzliche Informationen zur QuickInfo bereitstellen, wie sie angezeigt werden soll. Dieses Element kann eine Kombination aus den folgenden Werten sein:

NIF_MESSAGE (0x00000001)

0x00000001. Das uCallbackMessage-Element ist gültig.

NIF_ICON (0x00000002)

0x00000002. Das hIcon-Element ist gültig.

NIF_TIP (0x00000004)

0x00000004. Das SzTip-Element ist gültig.

NIF_STATE (0x00000008)

0x00000008. Die Elemente "dwState " und "dwStateMask " sind gültig.

NIF_INFO (0x00000010)

0x00000010. Anzeigen einer Sprechblasenbenachrichtigung. Die Mitglieder "szInfo", " szInfoTitle", "dwInfoFlags" und "uTimeout " sind gültig. Beachten Sie, dass uTimeout nur in Windows 2000 und Windows XP gültig ist.

  • Geben Sie zum Anzeigen der Benachrichtigung der Sprechblasen NIF_INFO an und geben Sie Text in szInfo an.
  • Um eine Benachrichtigung zu entfernen, geben Sie NIF_INFO an, und geben Sie eine leere Zeichenfolge über szInfo an.
  • Wenn Sie ein Benachrichtigungsbereichsymbol hinzufügen möchten, ohne eine Benachrichtigung anzuzeigen, legen Sie das NIF_INFO-Flag nicht fest.

NIF_GUID (0x00000020)

0x00000020.

  • Windows 7 und höher: Das guidItem ist gültig.
  • Windows Vista und früher: Reserviert.

NIF_REALTIME (0x00000040)

0x00000040. Windows Vista und höher. Wenn die Benachrichtigung der Sprechblase nicht sofort angezeigt werden kann, verwerfen Sie sie. Verwenden Sie dieses Flag für Benachrichtigungen, die Echtzeitinformationen darstellen, die bedeutungslos oder irreführend sind, wenn sie zu einem späteren Zeitpunkt angezeigt werden. Eine Nachricht, die z. B. "Ihr Telefon klingelt" angibt. NIF_REALTIME ist nur dann sinnvoll, wenn sie mit dem NIF_INFO Flag kombiniert werden.

NIF_SHOWTIP (0x00000080)

0x00000080. Windows Vista und höher. Verwenden Sie die Standardtoolinfo. Wenn uVersion auf NOTIFYICON_VERSION_4 festgelegt ist, wird die Standard-QuickInfo unterdrückt und kann durch die anwendungsgezeichnete, Popup-Benutzeroberfläche ersetzt werden. Wenn die Anwendung die Standard-Toolinfo mit NOTIFYICON_VERSION_4 anzeigen möchte, kann NIF_SHOWTIP angegeben werden, um anzugeben, dass die Standard-Toolinfo weiterhin angezeigt werden soll.

uCallbackMessage

Typ: UINT

Ein anwendungsdefinierter Nachrichtenbezeichner. Das System verwendet diesen Bezeichner, um Benachrichtigungsnachrichten an das in hWnd identifizierte Fenster zu senden. Diese Benachrichtigungsnachrichten werden gesendet, wenn ein Mausereignis oder ein Mauszeiger im Begrenzungsrechteck des Symbols auftritt, wenn das Symbol mit der Tastatur ausgewählt oder aktiviert wird oder wenn diese Aktionen in der Benachrichtigung der Sprechblasen auftreten.

Wenn das uVersion-Element entweder 0 oder NOTIFYICON_VERSION ist, enthält der wParam-Parameter der Nachricht den Bezeichner des Taskleistensymbols, in dem das Ereignis aufgetreten ist. Dieser Bezeichner kann 32 Bit lang sein. Der lParam-Parameter enthält die Maus- oder Tastaturnachricht, die dem Ereignis zugeordnet ist. Wenn der Zeiger beispielsweise über ein Taskleistensymbol verschoben wird, wird lParam auf WM_MOUSEMOVE festgelegt.

Wenn das uVersion-Element NOTIFYICON_VERSION_4 ist, erhalten Anwendungen weiterhin Benachrichtigungsereignisse in Form von anwendungsspezifischen Nachrichten über das uCallbackMessage-Element, aber die Interpretation der lParam- und wParam-Parameter dieser Nachricht wird wie folgt geändert:

  • LOWORD(lParam) enthält Benachrichtigungsereignisse wie NIN_BALLOONSHOW, NIN_POPUPOPEN oder WM_CONTEXTMENU.
  • HIWORD(lParam) enthält die Symbol-ID. Symbol-IDs sind auf eine Länge von 16 Bit beschränkt.
  • GET_X_LPARAM(wParam) gibt die X-Ankerkoordinate für Benachrichtigungsereignisse NIN_POPUPOPEN, NIN_SELECT, NIN_KEYSELECT und alle Mausnachrichten zwischen WM_MOUSEFIRST und WM_MOUSELAST zurück. Wenn eine dieser Nachrichten von der Tastatur generiert wird, wird wParam auf die obere linke Ecke des Zielsymbols festgelegt. Für alle anderen Nachrichten ist wParam nicht definiert.
  • GET_Y_LPARAM(wParam) gibt die Y-Ankerkoordinate für Benachrichtigungsereignisse und Nachrichten zurück, die für den X-Anker definiert sind.

hIcon

Typ: HICON

Ein Handle zum Hinzufügen, Ändern oder Löschen des Symbols. Windows XP und höher unterstützen Symbole von bis zu 32 BPP.

Wenn nur ein 16x16-Pixelsymbol bereitgestellt wird, wird es auf eine größere Größe in einem System, das auf einen hohen DPI-Wert festgelegt ist, skaliert. Dies kann zu einem unattraktiven Ergebnis führen. Es wird empfohlen, sowohl ein 16x16-Pixelsymbol als auch ein 32x32-Symbol in Ihrer Ressourcendatei bereitzustellen. Verwenden Sie LoadIconMetric , um sicherzustellen, dass das richtige Symbol geladen und entsprechend skaliert wird. Siehe Hinweise für ein Codebeispiel.

szTip[64]

Typ: TCHAR[64]

Eine null-beendete Zeichenfolge, die den Text für eine Standard-QuickInfo angibt. Es kann maximal 64 Zeichen enthalten, einschließlich des endenden Nullzeichens.

Für Windows 2000 und höher kann szTip maximal 128 Zeichen aufweisen, einschließlich des endenden Nullzeichens.

szTip[128]

Typ: TCHAR[64]

Eine null-beendete Zeichenfolge, die den Text für eine Standard-QuickInfo angibt. Es kann maximal 64 Zeichen enthalten, einschließlich des endenden Nullzeichens.

Für Windows 2000 und höher kann szTip maximal 128 Zeichen aufweisen, einschließlich des endenden Nullzeichens.

dwState

Art: DWORD

Windows 2000 und höher. Der Zustand des Symbols. Eine oder beide der folgenden Werte:

NIS_HIDDEN (0x00000001)

0x00000001. Das Symbol ist ausgeblendet.

NIS_SHAREDICON (0x00000002)

0x00000002. Die Symbolressource wird zwischen mehreren Symbolen freigegeben.

dwStateMask

Art: DWORD

Windows 2000 und höher. Ein Wert, der angibt, welche Bits des dwState-Elements abgerufen oder geändert werden. Die möglichen Werte entsprechen denen für dwState. Wenn Sie dieses Element beispielsweise auf NIS_HIDDEN festlegen, wird nur der ausgeblendete Zustand des Elements geändert, während der Symbolfreigabe-Bit unabhängig vom Wert ignoriert wird.

szInfo[256]

Typ: TCHAR[256]

Windows 2000 und höher. Eine null-beendete Zeichenfolge, die den Text angibt, der in einer Sprechblasenbenachrichtigung angezeigt werden soll. Es kann maximal 256 Zeichen aufweisen, einschließlich des endierenden Nullzeichens, sollte jedoch auf 200 Zeichen in Englisch beschränkt werden, um die Lokalisierung zu erfüllen. Um die Benachrichtigung der Sprechblasen aus der Benutzeroberfläche zu entfernen, löschen Sie entweder das Symbol (mit NIM_DELETE) oder legen Sie das NIF_INFO-Flag in uFlags fest, und legen Sie szInfo auf eine leere Zeichenfolge fest.

DUMMYUNIONNAME

DUMMYUNIONNAME.uTimeout

Typ: UINT

Windows 2000 und höher.

Hinweis Dieses Element ist als Windows Vista veraltet. Die Anzeigezeiten von Benachrichtigungen basieren nun auf den Einstellungen für Barrierefreiheit des Systems.
 
Union mit uVersion. Der Timeoutwert in Millisekunden für Benachrichtigungen. Das System erzwingt minimale und maximale Timeoutwerte. In uTimeout angegebene Werte, die zu groß sind, werden auf den Maximalwert festgelegt. Werte, die zu klein sind, auf den Mindestwert. Die Mindest- und Maximalzeitwerte des Systems werden derzeit auf 10 Sekunden und 30 Sekunden festgelegt. Weitere Hinweise zu uTimeout finden Sie in den Anmerkungen.

DUMMYUNIONNAME.uVersion

Typ: UINT

Windows 2000 und höher. Union mit uTimeout (veraltet als Windows Vista). Gibt an, welche Version der Shellbenachrichtigungssymbolschnittstelle verwendet werden soll. Weitere Informationen zu den Unterschieden in diesen Versionen finden Sie unter Shell_NotifyIcon. Dieses Mitglied wird nur bei verwendung von Shell_NotifyIcon zum Senden einer NIM_SETVERSION Nachricht verwendet.

szInfoTitle[64]

Typ: TCHAR[64]

Windows 2000 und höher. Eine null-beendete Zeichenfolge, die einen Titel für eine Benachrichtigung für eine Sprechblasenbenachrichtigung angibt. Dieser Titel wird direkt über dem Text in einer größeren Schriftart angezeigt. Es kann maximal 64 Zeichen aufweisen, einschließlich des terminierenden Nullzeichens, sollte jedoch auf 48 Zeichen in Englisch beschränkt werden, um die Lokalisierung zu erfüllen.

dwInfoFlags

Art: DWORD

Windows 2000 und höher. Flags, die festgelegt werden können, um das Verhalten und die Darstellung einer Benachrichtigung einer Sprechblasen zu ändern. Das Symbol wird links neben dem Titel platziert. Wenn das SzInfoTitle-Element null länge ist, wird das Symbol nicht angezeigt.

NIIF_NONE (0x00000000)

0x00000000. Kein Symbol.

NIIF_INFO (0x00000001)

0x00000001. Ein Informationssymbol.

NIIF_WARNING (0x00000002)

0x00000002. Ein Warnungssymbol.

NIIF_ERROR (0x00000003)

0x00000003. Ein Fehlersymbol.

NIIF_USER (0x00000004)

0x00000004. Windows XP SP2 und höher.

  • Windows XP: Verwenden Sie das symbol, das in hIcon als Titelsymbol des Benachrichtigungsblasens identifiziert wurde.
  • Windows Vista und höher: Verwenden Sie das symbol, das in hBalloonIcon als Titelsymbol des Benachrichtigungsblasens identifiziert wurde.

NIIF_NOSOUND (0x00000010)

0x00000010. Windows XP und höher. Spielen Sie den zugeordneten Sound nicht ab. Gilt nur für Benachrichtigungen.

NIIF_LARGE_ICON (0x00000020)

0x00000020. Windows Vista und höher. Die große Version des Symbols sollte als Benachrichtigungssymbol verwendet werden. Dies entspricht dem Symbol mit Abmessungen SM_CXICON x SM_CYICON. Wenn dieses Flag nicht festgelegt ist, wird das Symbol mit Dimensionen SM_CXSMICON x SM_CYSMICON verwendet.

  • Dieses Flag kann mit allen Aktiensymbolen verwendet werden.
  • Anwendungen, die ältere angepasste Symbole (NIIF_USER mit hIcon) verwenden, müssen eine neue SM_CXICON x SM_CYICON Version im Leistensymbol (hIcon) bereitstellen. Diese Symbole werden nach unten skaliert, wenn sie im Systemleisten- oder Systemsteuerungsbereich (SCA) angezeigt werden.
  • Neue angepasste Symbole (NIIF_USER mit hBalloonIcon) müssen eine SM_CXICON x SM_CYICON Version im angegebenen Symbol (hBalloonIcon) bereitstellen.

NIIF_RESPECT_QUIET_TIME (0x00000080)

0x00000080. Windows 7 und höher. Zeigen Sie die Benachrichtigung der Sprechblasen nicht an, wenn sich der aktuelle Benutzer in "stiller Zeit" befindet, was die erste Stunde ist, nachdem sich ein neuer Benutzer zum ersten Mal bei seinem Konto angemeldet hat. Während dieser Zeit sollten die meisten Benachrichtigungen nicht gesendet oder angezeigt werden. Dies ermöglicht es einem Benutzer, sich an ein neues Computersystem ohne diese Ablenkungen zu gewöhnt. Die Ruhezeit tritt auch für jeden Benutzer nach einem Betriebssystemupgrade oder einer sauberen Installation auf. Eine Benachrichtigung, die während der ruhen Zeit mit dieser Kennzeichnung gesendet wurde, ist nicht in der Warteschlange; es wird einfach nicht angezeigt. Die Anwendung kann die Benachrichtigung später erneut senden, wenn sie zu diesem Zeitpunkt noch gültig ist.

Da eine Anwendung nicht vorhersagbar ist, wann es zu stiller Zeit kommt, empfehlen wir, dass diese Kennzeichnung immer auf allen geeigneten Benachrichtigungen durch eine Anwendung festgelegt wird, die die ruhete Zeit zu ehren bedeutet.

Während der Ruhezeit sollten bestimmte Benachrichtigungen weiterhin gesendet werden, da sie vom Benutzer als Feedback als Reaktion auf eine Benutzeraktion erwartet werden, z. B. wenn er ein USB-Gerät angibt oder ein Dokument druckt.

Wenn der aktuelle Benutzer nicht in ruher Zeit ist, hat dieses Flag keine Auswirkung.

NIIF_ICON_MASK (0x0000000F)

0x0000000F. Windows XP und höher. Reserviert.

guidItem

Typ: GUID

Windows XP und höher.

  • Windows 7 und höher: Eine registrierte GUID, die das Symbol identifiziert. Dieser Wert überschreibt uID und ist die empfohlene Methode zum Identifizieren des Symbols. Das NIF_GUID-Flag muss im uFlags-Element festgelegt werden.
  • Windows XP und Windows Vista: Reserviert; muss auf 0 festgelegt werden.
Wenn Ihre Anwendung sowohl unter Windows Vista als auch unter Windows 7 ausgeführt werden soll, ist es unerlässlich, dass Sie die Version von Windows überprüfen und nur ein nichtzero guidItem angeben, wenn sie unter Windows 7 oder höher ausgeführt werden.

Wenn Sie das Benachrichtigungssymbol mit einer GUID in einem Aufruf zu Shell_NotifyIcon identifizieren, müssen Sie diese gleiche GUID verwenden, um das Symbol in allen nachfolgenden Shell_NotifyIcon Aufrufen zu identifizieren, die mit diesem Symbol arbeiten.

Um eine GUID für die Verwendung in diesem Member zu generieren, verwenden Sie ein GUID-generierendes Tool wie Guidgen.exe.

hBalloonIcon

Typ: HICON

Windows Vista und höher. Der Handle eines benutzerdefinierten Benachrichtigungssymbols, das von der Anwendung bereitgestellt wird, die unabhängig vom Symbol für den Benachrichtigungsbereich verwendet werden soll. Wenn dieses Element nicht NULL ist und das NIIF_USER-Flag im dwInfoFlags-Element festgelegt ist, wird dieses Symbol als Benachrichtigungssymbol verwendet. Wenn dieses Element NULL ist, wird das Legacyverhalten ausgeführt.

Hinweise

Weitere Informationen zur Benutzeroberfläche und bewährten Methoden für Benachrichtigungen finden Sie unter "Benachrichtigungen" in den Windows-Richtlinien für die Benutzeroberflächeninteraktion.

Wenn Sie das NIF_INFO Flag im uFlags-Element festlegen, wird die Benachrichtigung im Sprechblasenstil verwendet. Weitere Diskussionen zu diesen Benachrichtigungen finden Sie unter QuickInfos für Sprechblasen.

Für die Taskleiste können maximal eine Sprechblasebenachrichtigung angezeigt werden. Wenn eine Anwendung versucht, eine Benachrichtigung anzuzeigen, wenn bereits eine angezeigt wird, wird die neue Benachrichtigung in die Warteschlange gestellt und angezeigt, wenn die ältere Benachrichtigung weggeht. In Versionen von Windows vor Windows Vista wird die neue Benachrichtigung erst angezeigt, wenn die vorhandene Benachrichtigung für mindestens die Mindestzeitüberschreitung des Systems angezeigt wurde, unabhängig vom uTimeout-Wert der ursprünglichen Benachrichtigung. Wenn der Benutzer den Computer nicht verwendet, zählt das System diese Zeit nicht in Richtung des Timeouts.

Mehrere Mitglieder dieser Struktur werden nur für Windows 2000 und höher unterstützt. Um diese Member zu aktivieren, schließen Sie eine der folgenden Zeilen in die Kopfzeile ein:

// Windows Vista and later:
#define NTDDI_VERSION NTDDI_WIN2K
#define NTDDI_VERSION NTDDI_WINXP
#define NTDDI_VERSION NTDDI_VISTA

// Windows XP and earlier:
#define _WIN32_IE 0x0500

Beachten Sie, dass Sie die Struktur mit ihrer Größe initialisieren müssen. Wenn Sie die Größe der aktuell definierten Struktur verwenden, wird die Anwendung möglicherweise nicht mit früheren Versionen von Shell32.dll ausgeführt, die eine kleinere Struktur erwarten. Sie können Ihre Anwendung mit früheren Versionen von Shell32.dll ausführen, indem Sie die entsprechende Versionsnummer definieren (siehe Shell- und Common Controls-Versionen). Dies kann jedoch zu Problemen führen, wenn Ihre Anwendung auch auf neueren Systemen ausgeführt werden muss.

Sie können die Anwendungskompatibilität mit allen Shell32.dll Versionen beibehalten und gleichzeitig die aktuellen Headerdateien verwenden, indem Sie die Größe der NOTIFYICONDATA-Struktur entsprechend festlegen. Bevor Sie die Struktur initialisieren, verwenden Sie DllGetVersion , um zu bestimmen, welche Shell32.dll Version auf dem System installiert ist, und initialisieren Sie cbSize mit einem der folgenden Werte:

Shell32.dll Version cbSize
6.0.6 oder höher (Windows Vista und höher) sizeof(NOTIFYICONDATA)
6.0 (Windows XP) NOTIFYICONDATA_V3_SIZE
5.0 (Windows 2000) NOTIFYICONDATA_V2_SIZE
Versionen unter 5.0 NOTIFYICONDATA_V1_SIZE
 

Mit diesem Wert für cbSize kann Ihre Anwendung NOTIFYICONDATA in einer Methode verwenden, die mit früheren Shell32.dll Versionen kompatibel ist.

Das folgende Codebeispiel zeigt die Versionsüberprüfung, die eine Anwendung aktivieren kann, die das guidItem-Element verwendet, um sowohl unter Windows Vista als auch unter Windows 7 ausgeführt zu werden. Es stellt eine boolesche Funktion bereit, die TRUE zurückgibt, wenn das Betriebssystem Windows 7 ist. Es sei denn, dieses Element gibt TRUE zurück, muss das guidItem-Element auf 0 festgelegt werden.

Hinweis Dieser Code ist spezifisch für die Windows 7-Versionsnummer. Es wird erwartet, dass zukünftige Versionen von Windows und Windows Server das guidItem-Element unterstützen, und zu diesem Zeitpunkt muss dieser Code aktualisiert werden, um spätere Versionsnummern als gültig zu identifizieren.
 
BOOL IsWin7OrLater()
{
    // Initialize the OSVERSIONINFOEX structure.
    OSVERSIONINFOEX osvi;
    ZeroMemory(&osvi, sizeof(OSVERSIONINFOEX));
    osvi.dwOSVersionInfoSize = sizeof(OSVERSIONINFOEX);
    osvi.dwMajorVersion = 6;
    osvi.dwMinorVersion = 1;

    // Initialize the condition mask.
    DWORDLONG dwlConditionMask = 0;
    VER_SET_CONDITION(dwlConditionMask, VER_MAJORVERSION, VER_GREATER_EQUAL);
    VER_SET_CONDITION(dwlConditionMask, VER_MINORVERSION, VER_GREATER_EQUAL);

    // Perform the test.
    return VerifyVersionInfo(&osvi, 
                             VER_MAJORVERSION | VER_MINORVERSION,
                             dwlConditionMask);
}

Das folgende Codebeispiel zeigt die Verwendung von LoadIconMetric zum Laden eines Symbols für die Verwendung mit hohem DPI-Wert.

// Declare NOTIFYICONDATA details. 
// Error handling is omitted here for brevity. Do not omit it in your code.

NOTIFYICONDATA nid = {};
nid.cbSize = sizeof(nid);
nid.hWnd = hWnd;
nid.uFlags = NIF_ICON | NIF_TIP | NIF_GUID;

// Note: This is an example GUID only and should not be used.
// Normally, you should use a GUID-generating tool to provide the value to
// assign to guidItem.
static const GUID myGUID = 
    {0x23977b55, 0x10e0, 0x4041, {0xb8, 0x62, 0xb1, 0x95, 0x41, 0x96, 0x36, 0x69}};
nid.guidItem = myGUID;

// This text will be shown as the icon's tooltip.
StringCchCopy(nid.szTip, ARRAYSIZE(nid.szTip), L"Test application");

// Load the icon for high DPI.
LoadIconMetric(hInst, MAKEINTRESOURCE(IDI_SMALL), LIM_SMALL, &(nid.hIcon));

// Show the notification.
Shell_NotifyIcon(NIM_ADD, &nid) ? S_OK : E_FAIL;

Problembehandlung

Wenn Sie das guidItem-Element verwenden, um das Symbol zu identifizieren, und dieses Symbol wird nicht angezeigt oder einige Aufrufe zu Shell_NotifyIcon fehlschlagen, ist eine der folgenden Fälle die wahrscheinliche Ursache:
  1. Das NIF_GUID Flag wurde in jedem Aufruf auf Shell_NotifyIcon nicht festgelegt. Nachdem Sie das Benachrichtigungssymbol mit einer GUID in einem Aufruf von Shell_NotifyIcon identifiziert haben, müssen Sie dieselbe GUID verwenden, um das Symbol in allen nachfolgenden Shell_NotifyIcon Aufrufen zu identifizieren, die mit demselben Symbol umgehen.
  2. Die Binärdatei, die das Symbol enthält, wurde verschoben. Der Pfad der Binärdatei ist in der Registrierung der GUID des Symbols enthalten und kann nicht geändert werden. Einstellungen, die dem Symbol zugeordnet sind, werden nur dann beibehalten, wenn der Dateipfad und die GUID unverändert sind. Wenn der Pfad geändert werden muss, sollte die Anwendung alle GUID-Informationen entfernen, die hinzugefügt wurden, wenn das vorhandene Symbol registriert wurde. Nachdem diese Informationen entfernt wurden, können Sie die Binärdatei an einen neuen Speicherort verschieben und mit einer neuen GUID erneut registrieren. Alle Einstellungen, die der ursprünglichen GUID-Registrierung zugeordnet sind, gehen verloren.

    Dies tritt auch bei einer nebeneinander installierten Installation auf. Beim Umgang mit einer parallelen Installation sollten neue Versionen der Anwendung die GUID der Binärdatei aktualisieren.

    Hinweis Die einzige Ausnahme für eine verschobene Datei tritt auf, wenn sowohl die ursprünglichen als auch verschobenen Binärdateien Authenticode signiert sind, die vomselben Unternehmen signiert sind. In diesem Fall werden Einstellungen über die Verschiebung beibehalten.
     

Hinweis

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

Anforderungen

   
Unterstützte Mindestversion (Client) Windows XP [Nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Header shellapi.h

Weitere Informationen

Benachrichtigungen und der Benachrichtigungsbereich