Función NPPropertyDialog (npapi.h)

  • Artículo

Se llama cuando el usuario hace clic en un botón agregado mediante la función NPPropertyDialog . La función NPPropertyDialog se llama solo para las propiedades de red de archivos y directorios.

Sintaxis

DWORD NPPropertyDialog(
  [in] HWND   hwndParent,
  [in] DWORD  iButtonDlg,
  [in] DWORD  nPropSel,
  [in] LPWSTR lpFileName,
  [in] DWORD  nType
);

Parámetros

[in] hwndParent

Identificador de la ventana primaria que debe poseer el cuadro de diálogo de propiedades de archivo.

[in] iButtonDlg

Índice del botón que se ha presionado.

Este índice especifica qué cuadro de diálogo de propiedad se solicitó, empezando por uno para el primer botón devuelto de la función NPGetPropertyText . Si hay varios nombres de archivo seleccionados, se agrega 10 a este número. En otras palabras, si hay más de un archivo seleccionado y el usuario presiona el primer botón de propiedad definido por el proveedor, iButtonDlg será 11. Si solo hay un archivo seleccionado y el usuario presiona el segundo botón de propiedad de red, iButtonDlg será dos.

[in] nPropSel

Especifica los elementos en los que debe actuar el cuadro de diálogo de propiedad. Este parámetro puede ser uno de los valores siguientes.

Valor Significado
WNPS_FILE
 Un único archivo.
WNPS_DIR
 Un único directorio.
WNPS_MULT
 Selección de varios archivos, directorios o ambos.

[in] lpFileName

Puntero a los nombres de los elementos en los que debe actuar el cuadro de diálogo de propiedad. Los únicos elementos admitidos son archivos y directorios, por lo que los nombres de los elementos son nombres de archivo. Deben ser inequívocas, no contener caracteres comodín y ser completos, por ejemplo, C:\Local\Example.doc. Se deben separar varios nombres de archivo con espacios. Un nombre de archivo que contiene espacios se puede incluir entre comillas, por ejemplo, "C:\Mi archivo". En este caso, se trata como un nombre único. También se puede usar un símbolo de intercalación (^) como mecanismo de comillas para caracteres individuales, por ejemplo, C:\My^"File y "C:\My^"File" hacen referencia al archivo C:\My"File.

[in] nType

Especifica el tipo de elemento, que debe ser WNTYPE_FILE.

Valor devuelto

Si la función se realiza correctamente, devuelve WN_SUCCESS. Si la función presenta un error, devuelve un código de error. Llame a SetLastError para establecer este código de error extendido, que puede incluir los siguientes códigos de retorno.

Código devuelto Descripción
WN_BAD_VALUE
 Uno o varios parámetros son un formato o un valor inesperados.
WN_OUT_OF_MEMORY
 No hay memoria suficiente para mostrar el cuadro de diálogo.
WN_NET_ERROR
 Error de red.

Comentarios

Esta función solo se llama a en conjuntos de propiedades para las que NPGetPropertyText ha asignado un nombre de botón.

Esta función se usa en el Administrador de archivos para ver y modificar las propiedades de red (por ejemplo, permisos) para los archivos de un dispositivo de red. Si no se admite esta función, el Administrador de archivos no proporciona ningún comportamiento predeterminado.

En esta versión de la interfaz del proveedor de red, lpFileName solo puede apuntar a nombres de archivo. El proveedor de red debe devolver WN_BAD_VALUE si ve un dispositivo inadecuado.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado npapi.h

Consulte también

NPGetPropertyText

SetLastError