Función NPPropertyDialog (npapi.h)

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.

[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.

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

Consulte también

NPGetPropertyText

SetLastError