Função SHOpenPropSheetW (shlobj.h)
[SHOpenPropSheet está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele pode estar alterado ou indisponível em versões subsequentes.]
Cria uma folha de propriedades a partir de uma lista de chaves do Registro que contêm os CLSIDs das planilhas individuais e, em seguida, abre a folha de propriedades.
Sintaxe
BOOL SHOpenPropSheetW(
[in, optional] LPCWSTR pszCaption,
[in, optional] HKEY [] ahkeys,
UINT ckeys,
[in, optional] const CLSID *pclsidDefault,
[in] IDataObject *pdtobj,
[in, optional] IShellBrowser *psb,
[in, optional] LPCWSTR pStartPage
);
Parâmetros
[in, optional] pszCaption
Tipo: LPCTSTR
Um ponteiro para uma cadeia de caracteres que contém o legenda para a folha de propriedades. Esse valor poderá ser NULL se nenhuma legenda for necessária.
[in, optional] ahkeys
Tipo: HKEY[]
Uma matriz de chaves do Registro que representam os CLSIDs das folhas de propriedades individuais.
ckeys
Tipo: UINT
Valor UINT que especifica o número de folhas de propriedades na matriz especificada por ahkeys.
[in, optional] pclsidDefault
Tipo: const CLSID*
Um ponteiro para o CLSID padrão. Esse valor pode ser NULL.
[in] pdtobj
Tipo: IDataObject*
Um ponteiro para um IDataObject, um objeto OLE que pode ser usado para executar ações nas folhas de propriedades.
[in, optional] psb
Tipo: IShellBrowser*
Não usado.
[in, optional] pStartPage
Tipo: LPCTSTR
Um ponteiro para uma cadeia de caracteres que especifica a página inicial. Esse valor pode ser NULL.
Retornar valor
Tipo: BOOL
Retornará TRUE se a folha de propriedades tiver sido criada com êxito; caso contrário, FALSE.
Comentários
Observação
O cabeçalho shlobj.h define SHOpenPropSheet como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.
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.h |
Biblioteca | Shell32.lib |
DLL | Shell32.dll (versão 5.0 ou posterior) |