Método IPropertyPage::SetObjects (ocidl.h)
Fornece a página de propriedades com uma matriz de ponteiros para objetos associados a essa página de propriedades.
Quando a página de propriedades recebe uma chamada para IPropertyPage::Apply, ela deve enviar alterações de valor para esses objetos por meio de quaisquer interfaces apropriadas. A página de propriedades deve consultar essas interfaces. Esse método poderá falhar se os objetos não derem suporte às interfaces esperadas pela página de propriedades.
Sintaxe
HRESULT SetObjects(
[in] ULONG cObjects,
[in] IUnknown **ppUnk
);
Parâmetros
[in] cObjects
O número de ponteiros na matriz apontada por ppUnk. Se esse parâmetro for 0, a página de propriedades deverá liberar todos os ponteiros passados anteriormente para esse método.
[in] ppUnk
Um ponteiro para uma matriz de ponteiros de interface IUnknown em que cada ponteiro identifica um objeto exclusivo afetado pela folha de propriedades na qual esta (e possivelmente outra) páginas de propriedades são exibidas. A página de propriedades deve armazenar em cache esses ponteiros chamando AddRef para cada ponteiro nesse momento. Essa matriz de ponteiros é a mesma que foi passada para OleCreatePropertyFrame ou OleCreatePropertyFrameIndirect para invocar a folha de propriedades.
Retornar valor
Esse método pode retornar os valores de retorno padrão E_FAIL, E_INVALIDARG, E_OUTOFMEMORY e E_UNEXPECTED, bem como os valores a seguir.
Código de retorno | Descrição |
---|---|
|
A página de propriedades salvou com êxito os ponteiros necessários. |
|
Um dos objetos no ppUnk não deu suporte à interface esperada por esta página de propriedades e, portanto, essa página de propriedades não pode se comunicar com ela. |
|
O endereço em ppUnk não é válido. Por exemplo, pode ser NULL. |
Comentários
A página de propriedades é necessária para manter os ponteiros retornados por esse método ou outros consultados por meio deles. Se esses ponteiros IUnknown específicos forem mantidos, a página de propriedades deverá chamar AddRef por meio de cada um ao armatá-los, até o momento em que SetObjects é chamado com cObjects igual a 0. Nesse momento, a página de propriedades deve chamar Release por meio de cada ponteiro, liberando todos os objetos que ela mantinha.
O chamador deve fornecer à página de propriedades esses objetos antes de chamar IPropertyPage::Activate e deve chamar SetObjects com zero como o parâmetro ao desativar a página ou ao liberar o objeto inteiramente. Cada chamada para SetObjects com um parâmetro ppUnk não NULL deve ser correspondida com uma chamada posterior para SetObjects com 0 no parâmetro cObjects.
Anotações aos implementadores
E_NOTIMPL não é um valor retornado válido.Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
Plataforma de Destino | Windows |
Cabeçalho | ocidl.h |