Compartilhar via


Estrutura ShellCommandInfo (ndattrib.h)

A estrutura ShellCommandInfo contém dados necessários para iniciar um aplicativo adicional para opções de reparo manual.

Sintaxe

typedef struct tagShellCommandInfo {
  LPWSTR pwszOperation;
  LPWSTR pwszFile;
  LPWSTR pwszParameters;
  LPWSTR pwszDirectory;
  ULONG  nShowCmd;
} ShellCommandInfo, *PShellCommandInfo;

Membros

pwszOperation

Tipo: [string] LPWSTR

Um ponteiro para uma cadeia de caracteres terminada em nulo que contém a ação a ser executada. O conjunto de verbos disponíveis que especifica a ação depende do arquivo ou pasta específico. Em geral, as ações disponíveis no menu de atalho de um objeto estão disponíveis. Para obter mais informações, consulte a seção Comentários.

pwszFile

Tipo: [string] LPWSTR

Um ponteiro para uma cadeia de caracteres terminada em nulo que especifica o arquivo ou objeto no qual executar o verbo especificado. Para especificar um objeto de namespace shell, passe o nome de análise totalmente qualificado. Observe que nem todos os verbos têm suporte em todos os objetos. Por exemplo, nem todos os tipos de documento dão suporte ao verbo "print".

pwszParameters

Tipo: [string] LPWSTR

Um ponteiro para cadeias de caracteres terminadas em nulo que especifica os parâmetros a serem passados para o aplicativo, somente se o parâmetro pwszFile especificar um arquivo executável. O formato dessa cadeia de caracteres é determinado pelo verbo a ser invocado. Se pwszFile especificar um arquivo de documento, pwszParameters deverá ser NULL.

pwszDirectory

Tipo: [string] LPWSTR

Um ponteiro para uma cadeia de caracteres terminada em nulo que especifica o diretório padrão.

nShowCmd

Tipo: ULONG

Sinalizadores que especificam como um aplicativo deve ser exibido quando ele é aberto. Se pwszFile especificar um arquivo de documento, o sinalizador será simplesmente passado para o aplicativo associado. Cabe ao aplicativo decidir como lidar com isso.

Comentários

No caso de uma opção de reparo manual, o chamador pode usar essa estrutura para chamar a função ShellExecute para iniciar um aplicativo adicional que pode ajudar o usuário a reparar o problema.

Os verbos a seguir são usados em conexão com pwszOperation.

Termo Descrição
Editar Inicia um editor e abre o documento para edição. Se pwszFile não for um arquivo de documento, a função falhará.
Explorar Explora a pasta especificada pelo parâmetro pwszFile .
Encontrar Inicia uma pesquisa a partir do diretório especificado.
Aberto Abre o arquivo especificado pelo parâmetro pwszFile . O arquivo pode ser um arquivo executável, um arquivo de documento ou uma pasta.
Imprimir Imprime o arquivo de documento especificado pelo parâmetro pwszFile . Se pwszFile não for um arquivo de documento, a função falhará.
NULL Usado quando outros verbos não se aplicam.

Requisitos

Requisito Valor
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 ndattrib.h