enumeração _KF_REDIRECT_FLAGS (shobjidl_core.h)

  • Artigo

Sinalizadores usados por IKnownFolderManager::Redirect para especificar detalhes de um redirecionamento de pasta conhecido, como permissões e propriedade para a pasta redirecionada.

Syntax

typedef enum _KF_REDIRECT_FLAGS {
  KF_REDIRECT_USER_EXCLUSIVE = 0x1,
  KF_REDIRECT_COPY_SOURCE_DACL = 0x2,
  KF_REDIRECT_OWNER_USER = 0x4,
  KF_REDIRECT_SET_OWNER_EXPLICIT = 0x8,
  KF_REDIRECT_CHECK_ONLY = 0x10,
  KF_REDIRECT_WITH_UI = 0x20,
  KF_REDIRECT_UNPIN = 0x40,
  KF_REDIRECT_PIN = 0x80,
  KF_REDIRECT_COPY_CONTENTS = 0x200,
  KF_REDIRECT_DEL_SOURCE_CONTENTS = 0x400,
  KF_REDIRECT_EXCLUDE_ALL_KNOWN_SUBFOLDERS = 0x800
} ;

Constantes

 
KF_REDIRECT_USER_EXCLUSIVE
Valor: 0x1
Verifique se apenas o usuário tem permissão para acessar a pasta redirecionada.
KF_REDIRECT_COPY_SOURCE_DACL
Valor: 0x2
Copie a DACL da pasta de origem para o destino para manter as permissões de acesso atuais.
KF_REDIRECT_OWNER_USER
Valor: 0x4
Define o usuário como o proprietário de uma pasta de destino recém-criada, a menos que o usuário seja membro do grupo Administrador, nesse caso, Administrador é definido como o proprietário. Deve ser chamado com KF_REDIRECT_SET_OWNER_EXPLICIT.
KF_REDIRECT_SET_OWNER_EXPLICIT
Valor: 0x8
Defina o proprietário de uma pasta de destino recém-criada. Se o usuário pertencer ao grupo Administradores, Os Administradores serão atribuídos como proprietário. Deve ser chamado com KF_REDIRECT_OWNER_USER.
KF_REDIRECT_CHECK_ONLY
Valor: 0x10
Não execute um redirecionamento, basta marcar se o redirecionamento ocorreu. Nesse caso, IKnownFolderManager::Redirect retorna S_OK; caso contrário, ou se algumas ações permanecerem a serem concluídas, ela retornará S_FALSE.
KF_REDIRECT_WITH_UI
Valor: 0x20
Exibir interface do usuário durante o redirecionamento.
KF_REDIRECT_UNPIN
Valor: 0x40
Desafixar a pasta de origem.
KF_REDIRECT_PIN
Valor: 0x80
Fixe a pasta de destino.
KF_REDIRECT_COPY_CONTENTS
Valor: 0x200
Copie o conteúdo existente, arquivos e subpastas, da pasta conhecida para a pasta redirecionada.
KF_REDIRECT_DEL_SOURCE_CONTENTS
Valor: 0x400
Exclua o conteúdo da pasta de origem depois que eles forem copiados para a pasta redirecionada. Esse sinalizador só será válido se KF_REDIRECT_COPY_CONTENTS estiver definido.
KF_REDIRECT_EXCLUDE_ALL_KNOWN_SUBFOLDERS
Valor: 0x800
Reservado. Não use.

Comentários

Os sinalizadores KF_REDIRECT_OWNER_USER e KF_REDIRECT_SET_OWNER_EXPLICIT fornecem verificações de propriedade para a pasta de destino, se essa pasta existir. Por padrão, IKnownFolderManager::Redirect não executa verificações de propriedade. KF_REDIRECT_OWNER_USER e KF_REDIRECT_SET_OWNER_EXPLICIT só serão válidos se forem chamados juntos.

O tipo KF_REDIRECT_FLAGS é definido em Shobjidl.h, conforme mostrado aqui.

typedef DWORD KF_REDIRECT_FLAGS;

Requisitos

   
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Cabeçalho shobjidl_core.h (inclua Shobjidl.h)

Confira também

Exemplo de pastas conhecidas