estrutura SETRESULT_INFO (compstui.h)

A estrutura SETRESULT_INFO é usada como um parâmetro de entrada para a função de retorno de chamada do tipo PFNPROPSHEETUI de um aplicativo.

Sintaxe

typedef struct _SETRESULT_INFO {
  WORD    cbSize;
  WORD    wReserved;
  HANDLE  hSetResult;
  LRESULT Result;
} SETRESULT_INFO, *PSETRESULT_INFO;

Membros

cbSize

Tamanho fornecido por CPSUI, em bytes, da estrutura SETRESULT_INFO .

wReserved

Reservado.

hSetResult

Identificador fornecido por CPSUI para uma página de folha de propriedades adicionada, obtida do aplicativo. Para obter mais informações, consulte a seção Comentários abaixo.

Result

Identificador fornecido por CPSUI para uma página de folha de propriedades adicionada, obtida do aplicativo. Para obter mais informações, consulte a seção Comentários abaixo.

Comentários

Quando um aplicativo chama a função ComPropSheet do CPSUI, especificando um código de função de CPSFUNC_SET_RESULT, o CPSUI chama todas as funções registradas do tipo PFNPROPSHEETUI, especificando um motivo de PROPSHEETUI_REASON_SET_RESULT. Ao especificar esse motivo, o CPSUI também fornece uma estrutura SETRESULT_INFO .

Os valores contidos nos membros hSetResult e Result da estrutura são os valores lParam1 e lParam2 , respectivamente, que foram fornecidos à função ComPropSheet do CPSUI.

Cada uma das funções do tipo PFNPROPSHEETUI do aplicativo é chamada em ordem, desde a declarada mais recentemente até a primeira declarada, até que uma dessas funções forneça um valor retornado de menos de uma. Nesse ponto, CPSUI retorna de sua função ComPropSheet , fornecendo uma contagem do número de funções do tipo PFNPROPSHEETUI que foram chamadas.

Normalmente, a função do tipo PFNPROPSHEETUI de um aplicativo define o membro Result de sua estrutura PROPSHEETUI_INFO como o valor recebido no membro Result da estrutura SETRESULT_INFO. Em seguida, a função retorna um valor de 1 (ou maior), para que a próxima função do tipo PFNPROPSHEETUI também possa recebê-la. Cada função chamada subsequentemente é associada a uma página que é o pai da página associada à última função chamada. Uma função pode modificar o conteúdo do membro Result da estrutura SETRESULT_INFO, fazendo com que as funções associadas às páginas pai recebam o novo valor.

Requisitos

Requisito	Valor
Cabeçalho	compstui.h (inclua Compstui.h)