estrutura PERSIST_FOLDER_TARGET_INFO (shobjidl_core.h)

  • Artigo

Especifica a pasta de destino de um atalho de pasta e seus atributos. Essa estrutura é usada por IPersistFolder3::GetFolderTargetInfo e IPersistFolder3::InitializeEx.

Sintaxe

typedef struct _PERSIST_FOLDER_TARGET_INFO {
  PIDLIST_ABSOLUTE pidlTargetFolder;
  WCHAR            szTargetParsingName[260];
  WCHAR            szNetworkProvider[260];
  DWORD            dwAttributes;
  int              csidl;
} PERSIST_FOLDER_TARGET_INFO;

Membros

pidlTargetFolder

Tipo: PIDLIST_ABSOLUTE

Um PIDL totalmente qualificado da pasta de destino. Defina pidlTargetFolder como NULL se não for especificado.

szTargetParsingName[260]

Tipo: WCHAR[MAX_PATH]

Uma cadeia de caracteres Unicode terminada em nulo com o nome de análise da pasta de destino. Defina szTargetParsingName como uma cadeia de caracteres vazia se não for especificado.

szNetworkProvider[260]

Tipo: WCHAR[MAX_PATH]

Uma cadeia de caracteres Unicode terminada em nulo que especifica o tipo de provedor de rede que será usado ao associar à pasta de destino. O formato é o mesmo usado pela API WNet. Defina szNetworkProvider como uma cadeia de caracteres vazia se não for especificado.

dwAttributes

Tipo: DWORD

Um valor DWORD que contém sinalizadores FILE_ATTRIBUTE_* conforme definido em Winnt.h. Defina dwAttributes como -1 se não for especificado.

csidl

Tipo: int

O valor CSIDL da pasta de destino, se ele tiver um. Defina csidl como -1 se a pasta de destino não tiver um CSIDL. Além do valor CSIDL, você também pode definir os dois sinalizadores a seguir.

CSIDL_FLAG_PFTI_TRACKTARGET

Indica que a pasta de destino deve ser alterada se o usuário alterar o valor CSIDL subjacente da pasta de destino.

CSIDL_FLAG_CREATE

Indica que a pasta de destino deve ser criada se ela ainda não existir.

Comentários

Qualquer um ou todos os membros pidlTargetFolder, szTargetParsingName e csidl podem ser usados para especificar o local da pasta de destino.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho shobjidl_core.h (inclua Shobjidl.h)

Confira também

IPersistFolder3