função PifMgr_GetProperties (shlobj_core.h)
[PifMgr_GetProperties está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele pode estar alterado ou indisponível em versões subsequentes.]
Retorna um bloco de dados especificado de um arquivo .pif.
Sintaxe
int PifMgr_GetProperties(
[in, optional] HANDLE hProps,
[in, optional] PCSTR pszGroup,
[out, optional] void *lpProps,
int cbProps,
UINT flOpt
);
Parâmetros
[in, optional] hProps
Tipo: HANDLE
Um identificador para as propriedades de um aplicativo. Esse parâmetro deve ser definido como o valor retornado por PifMgr_OpenProperties.
[in, optional] pszGroup
Tipo: PCSTR
Uma cadeia de caracteres terminada em nulo que contém o nome do grupo de propriedades. Pode ser um dos seguintes ou qualquer outro nome que corresponda a uma extensão .pif válida.
"WINDOWS 286 3.0"
"WINDOWS 386 3.0"
"WINDOWS VMM 4.0"
"WINDOWS NT 3.1"
"WINDOWS NT 4.0"
[out, optional] lpProps
Tipo: void*
Quando essa função retorna, contém um ponteiro para uma estrutura PROPPRG .
cbProps
Tipo: int
O tamanho do buffer, em bytes, apontado por lpProps.
flOpt
Tipo: UINT
Defina esse parâmetro como GETPROPS_NONE.
Retornar valor
Tipo: int
Retornará NULL se tiver êxito. Se não tiver êxito, a função retornará o identificador para as propriedades do aplicativo que foram passadas como hProps.
Comentários
Se o bloco for um bloco "nomeado", ele deverá ser o nome de uma extensão vinculada dentro do arquivo .pif. Pode ser qualquer nome predefinido (como "WINDOWS 386 3.0") ou o nome do seu próprio bloco. Você pode criar seus próprios blocos de dados nomeados usando PifMgr_SetProperties. Os dados nomeados também podem ser considerados como dados brutos, pois são retornados ao aplicativo de chamada como estão, sem tradução.
O tamanho de um bloco nomeado pode ser determinado chamando PifMgr_GetProperties com cbProps definido como 0. Nenhum dado é copiado, mas o tamanho do bloco solicitado é retornado.
Todos os blocos nomeados podem ser enumerados definindo pszGroup como NULL. lpProps deve ser um ponteiro para um buffer de 16 bytes para conter o nome do bloco solicitado e cbProps deve ser definido como o índice de bloco baseado em zero. O valor retornado será o tamanho do bloco ou zero se o bloco não for encontrado.
Se você solicitar um bloco de propriedades sem nome definindo o seletor do parâmetro name como NULL e o deslocamento for um ordinal de grupo de propriedades, a estrutura associada será retornada. Por exemplo, PifMgr_GetProperties(GROUP_TSK) retorna uma estrutura predefinida que contém todas as informações relacionadas à tarefa em um formato independente do arquivo .pif. Esse é um serviço valioso porque alivia a chamada de aplicativos de lidar com arquivos .pif que contêm uma ampla variedade de seções (conhecidas como extensões .pif), quando apenas uma é necessária.
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 | shlobj_core.h |
| Biblioteca | Shell32.lib |
| DLL | Shell32.dll (versão 5.0 ou posterior) |