Estrutura STRRET (shtypes.h)

Contém cadeias de caracteres retornadas dos métodos de interface IShellFolder .

Sintaxe

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

Membros

uType

Tipo: UINT

Um valor que especifica o formato desejado da cadeia de caracteres. Esse pode ser um dos valores a seguir.

STRRET_CSTR

A cadeia de caracteres é retornada no membro cStr .

STRRET_OFFSET

O valor do membro uOffset indica o número de bytes do início da lista de identificadores de item em que a cadeia de caracteres está localizada.

STRRET_WSTR

A cadeia de caracteres está no endereço especificado pelo membro pOleStr .

DUMMYUNIONNAME

DUMMYUNIONNAME.pOleStr

Tipo: LPWSTR

Um ponteiro para a cadeia de caracteres. Essa memória deve ser alocada com CoTaskMemAlloc. É responsabilidade do aplicativo de chamada liberar essa memória com CoTaskMemFree quando ela não for mais necessária.

DUMMYUNIONNAME.uOffset

Tipo: UINT

O deslocamento para a lista de identificadores de item.

DUMMYUNIONNAME.cStr[260]

Tipo: CHAR[MAX_PATH]

O buffer a receber o nome de exibição.

Requisitos

Confira também

IShellFolder::GetDisplayNameOf