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)

Consulte también

PifMgr_CloseProperties

PifMgr_OpenProperties