función PifMgr_OpenProperties (shlobj_core.h)

[PifMgr_OpenProperties está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. Puede modificarse o no estar disponible en versiones posteriores.

Abre el archivo .pif asociado a una aplicación MS-DOS de Microsoft y devuelve un identificador a las propiedades de la aplicación.

Sintaxis

HANDLE PifMgr_OpenProperties(
  [in]           PCWSTR pszApp,
  [in, optional] PCWSTR pszPIF,
                 UINT   hInf,
                 UINT   flOpt
);

Parámetros

[in] pszApp

Tipo: PCWSTR

Cadena Unicode terminada en null que contiene el nombre de la aplicación.

[in, optional] pszPIF

Tipo: PCWSTR

Cadena Unicode terminada en null que contiene el nombre del archivo .pif.

hInf

Tipo: UINT

Identificador del archivo .inf de la aplicación. Establezca este valor en cero si no hay ningún archivo .inf. Establezca este valor en -1 para evitar que se procese el archivo .inf.

flOpt

Tipo: UINT

Marca que controla el funcionamiento de la función.

OPENPROPS_INHIBITPIF

Omita los archivos .pif existentes y obtenga las propiedades de win.ini o _Default.pif. Esta marca se omite en Windows NT, Windows 2000 y Windows XP.

OPENPROPS_NONE

Ninguna opción especificada.

Valor devuelto

Tipo: HANDLE

Devuelve un identificador a las propiedades de la aplicación. Use este identificador cuando llame a las funciones .pif relacionadas.

Comentarios

No debería pensar en PifMgr_OpenProperties como una función que abre un archivo en algún lugar. El archivo .pif no permanece abierto después de esta llamada. Es más útil pensar en la función como un asignador de estructura de propiedades que se puede inicializar mediante datos de disco. La razón principal por la que se produce un error en esta función se debe a una memoria baja o a la incapacidad de abrir el archivo .pif especificado.

Si no existe ningún archivo .pif, la función sigue asignando un bloque de datos en la memoria e inicializa con datos de _Default.pif o sus valores predeterminados internos. Si la función busca un nombre de archivo .pif pero no lo encuentra, construye un nombre y lo guarda en su estructura de datos .pif interna. Esto garantiza que, si se llama a PifMgr_SetProperties , los datos se guardan en el disco.

Si la función no encuentra el archivo .pif, la busca en el orden siguiente.

1. Busca en el directorio actual.
2. Busca en el directorio especificado.
3. Busca en el directorio .pif.
4. Busca en las carpetas especificadas por la variable de entorno PATH.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	shlobj_core.h
Library	Shell32.lib
Archivo DLL	Shell32.dll (versión 5.0 o posterior)

Consulte también

PifMgr_CloseProperties

PifMgr_GetProperties