NMTBRESTORE-Struktur (commctrl.h)

Ermöglicht Anwendungen das Extrahieren der Informationen, die beim Speichern des Symbolleistenstatus in NMTBSAVE platziert wurden. Diese Struktur wird an Anwendungen übergeben, wenn sie einen TBN_RESTORE Benachrichtigungscode erhalten.

Syntax

typedef struct tagNMTBRESTORE {
  NMHDR    hdr;
  DWORD    *pData;
  DWORD    *pCurrent;
  UINT     cbData;
  int      iItem;
  int      cButtons;
  int      cbBytesPerRecord;
  TBBUTTON tbButton;
} NMTBRESTORE, *LPNMTBRESTORE;

Member

hdr

Typ: NMHDR

NMHDR-Struktur , die zusätzliche Informationen zur Benachrichtigung enthält.

pData

Typ: DWORD*

Zeiger auf den Datenstrom mit den gespeicherten Speicherinformationen. Sie enthält von shelldefinierte Informationsblöcke für jede Schaltfläche im Wechsel mit anwendungsdefinierte Blöcken. Anwendungen können auch einen Block globaler Daten am Anfang von pData platzieren. Das Format und die Länge der anwendungsdefinierte Blöcke werden von der Anwendung bestimmt.

pCurrent

Typ: DWORD*

Zeiger auf den aktuellen Block anwendungsdefinierter Daten. Nach dem Extrahieren der Daten muss die Anwendung pCurrent bis zum Ende des Blocks voranbringen, sodass sie auf den nächsten Block mit von Shell definierten Daten zeigt.

cbData

Typ: UINT

Größe von pData.

iItem

Typ: int

Der Wert von -1 gibt an, dass die Wiederherstellung gestartet wird, und pCurrent zeigt auf den Anfang des Datenstroms. Andernfalls handelt es sich um den nullbasierten Schaltflächenindex, und pCurrent zeigt auf die Daten der aktuellen Schaltfläche.

cButtons

Typ: int

Schätzung der Anzahl der Schaltflächen. Da die Schätzung auf der Größe des Datenstroms basiert, ist sie möglicherweise falsch. Der Client sollte ihn nach Bedarf aktualisieren.

cbBytesPerRecord

Typ: int

Anzahl der Bytes, die zum Speichern der Daten für jede Schaltfläche erforderlich sind. Wenn die Wiederherstellung gestartet wird, wird cbBytesPerRecord auf die Größe der von Shell definierten Datenstruktur festgelegt. Sie müssen sie um die Größe der Struktur erhöhen, die die anwendungsdefinierte Daten enthält.

tbButton

Typ: TBBUTTON

TBBUTTON-Struktur , die Informationen zur Schaltfläche enthält, die derzeit wiederhergestellt wird. Anwendungen müssen diese Struktur nach Bedarf ändern, bevor sie zurückgegeben werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	commctrl.h