Partager via

Structure ShellCommandInfo (ndattrib.h)

  • Article

La structure ShellCommandInfo contient les données requises pour lancer une application supplémentaire pour les options de réparation manuelle.

Syntaxe

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

Membres

pwszOperation

Type : [string] LPWSTR

Pointeur vers une chaîne terminée par null qui contient l’action à effectuer. L’ensemble des verbes disponibles qui spécifie l’action dépend du fichier ou dossier particulier. En règle générale, les actions disponibles dans le menu contextuel d’un objet sont des verbes disponibles. Pour plus d'informations, consultez la section Notes.

pwszFile

Type : [string] LPWSTR

Pointeur vers une chaîne terminée par null qui spécifie le fichier ou l’objet sur lequel exécuter le verbe spécifié. Pour spécifier un objet d’espace de noms Shell, passez le nom complet de l’analyse. Notez que tous les verbes ne sont pas pris en charge sur tous les objets. Par exemple, tous les types de documents ne prennent pas en charge le verbe « imprimer ».

pwszParameters

Type : [string] LPWSTR

Pointeur vers des chaînes terminées par un caractère Null qui spécifie les paramètres à passer à l’application, uniquement si le paramètre pwszFile spécifie un fichier exécutable. Le format de cette chaîne est déterminé par le verbe à appeler. Si pwszFile spécifie un fichier de document, pwszParameters doit avoir la valeur NULL.

pwszDirectory

Type : [string] LPWSTR

Pointeur vers une chaîne terminée par null qui spécifie le répertoire par défaut.

nShowCmd

Type : ULONG

Indicateurs qui spécifient comment une application doit être affichée lors de son ouverture. Si pwszFile spécifie un fichier de document, l’indicateur est simplement passé à l’application associée. C’est à l’application de décider comment la gérer.

Remarques

Dans le cas d’une option de réparation manuelle, l’appelant peut utiliser cette structure pour appeler la fonction ShellExecute afin de lancer une application supplémentaire qui peut aider l’utilisateur à réparer le problème.

Les verbes suivants sont utilisés en relation avec pwszOperation.

Terme Description
Modifier Lance un éditeur et ouvre le document pour modification. Si pwszFile n’est pas un fichier document, la fonction échoue.
Explorer Explore le dossier spécifié par le paramètre pwszFile .
Trouver Lance une recherche à partir du répertoire spécifié.
Ouvert Ouvre le fichier spécifié par le paramètre pwszFile . Le fichier peut être un fichier exécutable, un fichier document ou un dossier.
Imprimer Imprime le fichier de document spécifié par le paramètre pwszFile . Si pwszFile n’est pas un fichier document, la fonction échoue.
NULL Utilisé lorsque d’autres verbes ne s’appliquent pas.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
En-tête ndattrib.h