función PifMgr_GetProperties (shlobj_core.h)
[PifMgr_GetProperties está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. Puede modificarse o no estar disponible en versiones posteriores.
Devuelve un bloque de datos especificado de un archivo .pif.
Sintaxis
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
Identificador de las propiedades de una aplicación. Este parámetro debe establecerse en el valor devuelto por PifMgr_OpenProperties.
[in, optional] pszGroup
Tipo: PCSTR
Cadena terminada en null que contiene el nombre del grupo de propiedades. Puede ser uno de los siguientes o cualquier otro nombre que corresponda a una extensión .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*
Cuando esta función vuelve, contiene un puntero a una estructura PROPPRG .
cbProps
Tipo: int
Tamaño del búfer, en bytes, al que apunta lpProps.
flOpt
Tipo: UINT
Establezca este parámetro en GETPROPS_NONE.
Valor devuelto
Tipo: int
Devuelve NULL si se ejecuta correctamente. Si no se realiza correctamente, la función devuelve el identificador a las propiedades de la aplicación que se pasaron como hProps.
Comentarios
Si el bloque es un bloque "con nombre", debe ser el nombre de una extensión vinculada dentro del archivo .pif. Puede ser cualquier nombre predefinido (por ejemplo, "WINDOWS 386 3.0") o el nombre de su propio bloque. Puede crear sus propios bloques de datos con nombre mediante PifMgr_SetProperties. Los datos con nombre también se pueden considerar como datos sin procesar, ya que se devuelven a la aplicación que realiza la llamada tal cual, sin traducción.
El tamaño de un bloque con nombre se puede determinar llamando a PifMgr_GetProperties con cbProps establecido en 0. No se copia ningún dato, pero se devuelve el tamaño del bloque solicitado.
Todos los bloques con nombre se pueden enumerar estableciendo pszGroup en NULL. lpProps debe ser un puntero a un búfer de 16 bytes para contener el nombre de bloque solicitado y cbProps debe establecerse en el índice de bloque de base cero. El valor devuelto es el tamaño del bloque o cero si no se encuentra el bloque.
Si solicita un bloque de propiedades sin nombre estableciendo el selector del parámetro name en NULL y el desplazamiento es un ordinal de grupo de propiedades, se devuelve la estructura asociada. Por ejemplo, PifMgr_GetProperties(GROUP_TSK) devuelve una estructura predefinida que contiene toda la información relacionada con tareas en un formato independiente del archivo .pif. Se trata de un servicio valioso porque alivia la llamada a aplicaciones de tratar con archivos .pif que contienen una amplia variedad de secciones (conocidas como extensiones .pif), cuando solo se requiere una.
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) |