IContextMenu::GetCommandString

9/9/2008

O GetCommandString método é chamado pelo shell para validar que o comando existe, a get o nome do comando canônico, ou para get o texto de ajuda de comando.

Syntax

HRESULT GetCommandString(
  UINT idCmd,
  UINT uType,
  UINT * pwReserved,
  LPSTR pszName,
  UINT cchMax
);

Parameters

• idCmd
  [no] Especifica o item de menu identificação, deslocamento a partir de idCmdFirst parâmetro de QueryContextMenu.

• uType
  [no] Máscara de bits que especifica que GetCommandString Um deve validar que o comando existe, get a seqüência de caracteres Nome de comando, ou get a Ajuda seqüência de caracteres de texto. Para obter uma lista de valores sinalizador possíveis, consulte a tabela abaixo.

• pwReserved
  Reservado (ignorado, deve transmitir NULL).

• pszName
  [no] Especifica a reserva seqüência de caracteres.

• cchMax
  [no] Especifica o tamanho da reserva de seqüência de caracteres.

Return Value

GetCommandString Retorna S_OK Se itsuccessfully valida que o comando existe, se ela retorna o nome de comando com êxito, ou se ele com êxito retornará ajuda de comando seqüência de caracteres de texto. GetCommandString Retorna um apropriado código de erro se ele foi malsucedido.

Remarks

O comando pode ser chamado programaticamente Se você transmitir o recuperados comando nome seqüência de caracteres para IContextMenu::InvokeCommand.

A seguinte tabela lista as possíveis uFlags Os valores.

Sinalizador	Valor	Descrição
GCS_VERB	0 x 00000000	Recuperar o nome de comando especificado como um verbo canônico
GCS_HELPTEXT	0 x 00000001	Recuperar o texto de ajuda para barra de status do File Explorer
GCS_VALIDATE	0 x 00000002	Validar a existência de comando

Requirements

Header	shlobj.h
Windows Embedded CE	Windows CE 3.0 and later
Windows Mobile	Pocket PC 2000 and later

See Also

Reference

IContextMenu
IContextMenu::InvokeCommand
IContextMenu::QueryContextMenu