STRRET-Struktur (shtypes.h)

  • Artikel

Enthält Zeichenfolgen, die von den Methoden der IShellFolder-Schnittstelle zurückgegeben werden.

Syntax

typedef struct _STRRET {
  UINT  uType;
  union {
    LPWSTR pOleStr;
    UINT   uOffset;
    char   cStr[260];
  } DUMMYUNIONNAME;
} STRRET;

Member

uType

Typ: UINT

Ein -Wert, der das gewünschte Format der Zeichenfolge angibt. Dies kann einer der folgenden Werte sein.

STRRET_CSTR

Die Zeichenfolge wird im cStr-Element zurückgegeben.

STRRET_OFFSET

Der uOffset-Elementwert gibt die Anzahl der Bytes ab dem Anfang der Elementbezeichnerliste an, in der sich die Zeichenfolge befindet.

STRRET_WSTR

Die Zeichenfolge befindet sich an der Vom pOleStr-Element angegebenen Adresse.

DUMMYUNIONNAME

DUMMYUNIONNAME.pOleStr

Typ: LPWSTR

Ein Zeiger auf die Zeichenfolge. Dieser Arbeitsspeicher muss mit CoTaskMemAlloc zugeordnet werden. Es liegt in der Verantwortung der aufrufenden Anwendung, diesen Arbeitsspeicher mit CoTaskMemFree freizugeben, wenn er nicht mehr benötigt wird.

DUMMYUNIONNAME.uOffset

Typ: UINT

Der Offset in der Elementbezeichnerliste.

DUMMYUNIONNAME.cStr[260]

Typ: CHAR[MAX_PATH]

Der Puffer, der den Anzeigenamen empfangen soll.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Kopfzeile shtypes.h

Weitere Informationen

IShellFolder::GetDisplayNameOf