Función SHOpenPropSheetA (shlobj.h)

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

Crea una hoja de propiedades a partir de una lista de claves del Registro que contienen la CLSIDs de las hojas individuales y, a continuación, abre la hoja de propiedades.

Sintaxis

BOOL SHOpenPropSheetA(
  [in, optional] LPCSTR        pszCaption,
  [in, optional] HKEY []       ahkeys,
                 UINT          ckeys,
  [in, optional] const CLSID   *pclsidDefault,
  [in]           IDataObject   *pdtobj,
  [in, optional] IShellBrowser *psb,
  [in, optional] LPCSTR        pStartPage
);

Parámetros

[in, optional] pszCaption

Tipo: LPCTSTR de

Puntero a una cadena que contiene el título de la hoja de propiedades. Este valor puede ser NULL si no se necesita ningún título.

[in, optional] ahkeys

Tipo: HKEY[]

Matriz de claves del Registro que representan la CLSIDs de las hojas de propiedades individuales.

ckeys

Tipo: UINT

valor de UINT que especifica el número de hojas de propiedades de la matriz especificada por ahkeys.

[in, optional] pclsidDefault

Tipo: const CLSID*

Puntero al CLSID predeterminado. Este valor puede ser null.

[in] pdtobj

Tipo: IDataObject

Puntero a un IDataObject, un objeto OLE que se puede usar para realizar acciones en las hojas de propiedades.

[in, optional] psb

Tipo: IShellBrowser

No se usa.

[in, optional] pStartPage

Tipo: LPCTSTR de

Puntero a una cadena que especifica la página de inicio. Este valor puede ser null.

Valor devuelto

Tipo: BOOL de

Devuelve TRUE si la hoja de propiedades se creó correctamente; De lo contrario, FALSE.

Observaciones

Nota

El encabezado shlobj.h define SHOpenPropSheet como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows XP [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows Server 2003 [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	shlobj.h
biblioteca de	Shell32.lib
DLL de	Shell32.dll (versión 5.0 o posterior)