STRRET 結構 (shtypes.h)

包含從 IShellFolder 介面方法傳回的字串。

語法

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

成員

uType

類型: UINT

值,指定所需的字串格式。 這可以是下列其中一個值。

STRRET_CSTR

字串會在 cStr 成員中傳回。

STRRET_OFFSET

uOffset 成員值表示字串所在專案標識符清單開頭的位元元組數目。

STRRET_WSTR

字串位於 pOleStr 成員指定的位址。

DUMMYUNIONNAME

DUMMYUNIONNAME.pOleStr

類型: LPWSTR

字串的指標。 此記憶體必須與 CoTaskMemAlloc 一起配置。 呼叫端應用程式必須負責在不再需要時,使用 CoTaskMemFree 釋放此記憶體。

DUMMYUNIONNAME.uOffset

類型: UINT

項目識別碼清單中的位移。

DUMMYUNIONNAME.cStr[260]

類型: CHAR[MAX_PATH]

要接收顯示名稱的緩衝區。

規格需求

需求
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
標頭 shtypes.h

另請參閱

IShellFolder::GetDisplayNameOf