Função SHObjectProperties (shlobj_core.h)

Artigo
03/02/2024

[SHObjectProperties está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele pode estar alterado ou indisponível em versões subsequentes.]

Invoca o comando de menu de contexto Propriedades em um objeto Shell.

Sintaxe

BOOL SHObjectProperties(
  [in] HWND   hwnd,
  [in] DWORD  shopObjectType,
  [in] PCWSTR pszObjectName,
  [in] PCWSTR pszPropertyPage
);

Parâmetros

[in] hwnd

Digite: HWND

O identificador da janela pai da caixa de diálogo. Esse valor pode ser NULL.

[in] shopObjectType

Tipo: DWORD

Um valor de sinalizador que especifica o tipo de objeto.

SHOP_PRINTERNAME

pszObjectName contém o nome amigável de uma impressora.

SHOP_FILEPATH

pszObjectName contém um nome de arquivo totalmente qualificado.

SHOP_VOLUMEGUID

pszObjectName contém (a) um nome de volume do formulário \?\Volume{GUID}, em que {GUID} é um identificador globalmente exclusivo (por exemplo, "\?\Volume{2eca078d-5cbc-43d3-aff8-7e8511f60d0e})", ou (b) um caminho de unidade (por exemplo, "C:").

[in] pszObjectName

Tipo: PCWSTR

Uma cadeia de caracteres Unicode terminada em nulo que contém o nome do objeto. O conteúdo da cadeia de caracteres é determinado pelo sinalizador definido em shopObjectType.

[in] pszPropertyPage

Tipo: PCWSTR

Uma cadeia de caracteres Unicode terminada em nulo que contém o nome da página da folha de propriedades a ser aberta inicialmente. Defina esse parâmetro como NULL para especificar a página padrão.

Retornar valor

Tipo: BOOL

TRUE se o comando for invocado com êxito; caso contrário, FALSE.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shlobj_core.h (inclua Shlobj.h)
Biblioteca	Shell32.lib
DLL	Shell32.dll (versão 5.0 ou posterior)

Compartilhar via