Función NPGetPropertyText (npapi.h)

Recupera los nombres de los botones que se van a agregar a un cuadro de diálogo de propiedades para un recurso de red.

Sintaxis

DWORD NPGetPropertyText(
  [in]      DWORD  iButton,
  [in]      DWORD  nPropSel,
  [in]      LPWSTR lpName,
  [out]     LPWSTR lpButtonName,
  [in, out] DWORD  nButtonNameLen,
  [in]      DWORD  nType
);

Parámetros

[in] iButton

Indica el índice del botón. El Administrador de archivos admite un máximo de seis botones. Este parámetro se numera de 1 a 6 para cada uno de los botones posibles si solo se selecciona un archivo o 11-16 si se seleccionan varios archivos.

[in] nPropSel

Especifica en qué elementos se centra el cuadro de diálogo de propiedades. 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] lpName

Puntero a una cadena terminada en NULL que contiene los nombres del elemento o los elementos que se van a ver o editar mediante el cuadro de diálogo. Los únicos elementos admitidos son archivos y directorios, por lo que los nombres de elemento 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 puede estar entre comillas (por ejemplo, "C:\Mi archivo"). En este caso. se trata como un único nombre. El carácter de intercalación '^' también se puede usar como mecanismo de comillas para caracteres únicos (por ejemplo, C:\My^"File, "C:\My^"File" ambos hacen referencia al archivo C:\My"File).

[out] lpButtonName

Puntero a un búfer donde el proveedor de red debe copiar el nombre del botón de propiedad. Si se ejecuta correctamente, el búfer al que apunta lpButtonName contiene el nombre del botón de propiedad. Si este búfer, al salir, contiene la cadena vacía, el botón correspondiente a ese nombre y todos los botones correctos se quitarán del cuadro de diálogo. El proveedor de red no puede "omitir" un botón.

[in, out] nButtonNameLen

Especifica el tamaño del búfer lpButtonName en caracteres, incluido el carácter nulo de terminación.

[in] nType

Especifica el tipo de elemento, que debe ser WNTYPE_FILE.

Valor devuelto

Si la función se ejecuta correctamente, debe devolver WN_SUCCESS y lpButtonName se puede usar. Si apunta a la cadena vacía, ningún botón corresponde a un índice tan alto como iButton. Si el valor devuelto es distinto de WN_SUCCESS, el proveedor también debe llamar a SetLastError para establecer información de error extendida. Los códigos de error extendidos incluyen lo siguiente.

Código devuelto	Descripción
WN_OUT_OF_MEMORY	No se pudo cargar la cadena de los recursos.
WN_MORE_DATA	El búfer especificado es demasiado pequeño para ajustarse al texto del botón.
WN_BAD_VALUE	El parámetro lpName es un formulario inesperado.
WN_NOT_SUPPORTED	Los cuadros de diálogo de propiedades no se admiten para el tipo de objeto especificado, nType.

Comentarios

El Administrador de archivos llama a esta función cada vez que se abre el cuadro de diálogo de propiedades y lo hace antes de mostrar el cuadro de diálogo. Si el usuario hace clic en un botón agregado a través de esta función por el proveedor de red, se llama a la función NPPropertyDialog con los parámetros adecuados.

Solo el Administrador de archivos llama a NPGetPropertyText y usa esta función para archivos y directorios.

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