PropSheet_GetResult macro (prsht.h)

Usado por folhas de propriedades modeless para recuperar as informações retornadas às folhas de propriedades modais PropertySheet. Você pode usar essa macro ou enviar a mensagem PSM_GETRESULT explicitamente.

Sintaxe

int PropSheet_GetResult(
   HWND hDlg
);

Parâmetros

hDlg

Tipo: HWND

Manipule para a caixa de diálogo da folha de propriedades.

Valor de retorno

Tipo: int

Retorna um valor positivo se tiver êxito ou -1 caso contrário. Os valores retornados a seguir têm um significado especial.

Código de retorno Descrição
ID_PSREBOOTSYSTEM Uma página enviou uma mensagem PSM_REBOOTSYSTEM para a folha de propriedades. O computador deve ser reiniciado para que as alterações do usuário entrem em vigor.
ID_PSRESTARTWINDOWS Uma página enviou uma mensagem PSM_RESTARTWINDOWS para a folha de propriedades. O Windows deve ser reiniciado para que as alterações do usuário entrem em vigor.

Observações

Para recuperar informações de erro estendidas, chame GetLastError.

O valor retornado é idêntico ao que PropertySheet teria retornado se essa fosse uma folha de propriedades modal.

Versão 5.80. O PropertySheet valor retornado contém informações diferentes para folhas de propriedades modais e modeless. Em alguns casos, as folhas de propriedades de modelagem podem precisar das informações que teriam recebido de PropertySheet se tivessem sido modais. Em particular, eles podem precisar saber se ID_PSREBOOTSYSTEM ou ID_PSRESTARTWINDOWS teriam sido retornados.

Para uma folha de propriedades de modelagem, o loop de mensagem deve usar PSM_ISDIALOGMESSAGE para passar mensagens para a caixa de diálogo da folha de propriedades e PSM_GETCURRENTPAGEHWND para determinar quando destruir a caixa de diálogo. Quando o usuário clica no botão OK ou Cancelar, PSM_GETCURRENTPAGEHWND retorna NULL. Em seguida, você pode recuperar o valor que uma folha de propriedades modal teria recebido de PropertySheet enviando uma mensagem de PSM_GETRESULT.

Observação Não há suporte para essa macro ao usar o estilo do assistente do Aero (PSH_AEROWIZARD).
 

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
cabeçalho prsht.h