função PifMgr_OpenProperties (shlobj_core.h)
[PifMgr_OpenProperties está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele pode estar alterado ou indisponível em versões subsequentes.]
Abre o arquivo .pif associado a um aplicativo MS-DOS da Microsoft e retorna um identificador para as propriedades do aplicativo.
Sintaxe
HANDLE PifMgr_OpenProperties(
[in] PCWSTR pszApp,
[in, optional] PCWSTR pszPIF,
UINT hInf,
UINT flOpt
);
Parâmetros
[in] pszApp
Tipo: PCWSTR
Uma cadeia de caracteres Unicode terminada em nulo que contém o nome do aplicativo.
[in, optional] pszPIF
Tipo: PCWSTR
Uma cadeia de caracteres Unicode terminada em nulo que contém o nome do arquivo .pif.
hInf
Tipo: UINT
Um identificador para o arquivo .inf do aplicativo. Defina esse valor como zero se não houver nenhum arquivo .inf. Defina esse valor como -1 para impedir que o arquivo .inf seja processado.
flOpt
Tipo: UINT
Um sinalizador que controla como a função opera.
OPENPROPS_INHIBITPIF
Ignore todos os arquivos .pif existentes e obtenha as propriedades de win.ini ou _Default.pif. Esse sinalizador é ignorado em Windows NT, Windows 2000 e Windows XP.
OPENPROPS_NONE
Nenhuma opção especificada.
Retornar valor
Tipo: HANDLE
Retorna um identificador para as propriedades do aplicativo. Use esse identificador ao chamar as funções .pif relacionadas.
Comentários
Você não deve pensar em PifMgr_OpenProperties como uma função que abre um arquivo em algum lugar. O arquivo .pif não permanece aberto após essa chamada. É mais útil pensar na função como um alocador de estrutura de propriedades que você pode inicializar usando dados de disco. O principal motivo pelo qual essa função falha é devido à baixa memória ou à incapacidade de abrir o arquivo .pif especificado.
Se nenhum arquivo .pif existir, a função ainda alocará um bloco de dados na memória e o inicializará com dados de _Default.pif ou seus padrões internos. Se a função procurar um nome de arquivo .pif, mas não o encontrar, ela construirá um nome e o salvará em sua estrutura de dados .pif interna. Isso garante que, se PifMgr_SetProperties for chamado, os dados serão salvos no disco.
Se a função não encontrar o arquivo .pif, ela o procurará na ordem a seguir.
- Pesquisa o diretório atual.
- Pesquisa o diretório especificado.
- Pesquisa no diretório .pif.
- Pesquisa as pastas especificadas pela variável de ambiente PATH.
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) |