<Source>.Password (Función)

AYUDA EN LÍNEA
WINDEV, WEBDEV Y WINDEV MOBILE

Versión:

Inicio | Iniciar sesión | Español

Ayuda / WLanguage / Administrar bases de datos / HFSQL / Funciones HFSQL

When to use <Source>.Password?
Defining a password on a data file
Deleting the password defined on a data file
Managing passwords (OLE DB and Native Accesses)

WINDEV

WEBDEV

WINDEV Mobile

Otros

Ver también

<Source>.Password (Función)

Disponible solo con estos tipos de conexión

Defines the password used to create or open a data file. The password is stored and it will be used when opening or creating the data file if no password is specified.

Remarks:

Attention A password is required to encrypt data. The data encryption must be configured during the file description in the data model editor ("Details" tab).
This password can also be specified in the functions for creating the data file (<Fuente>.Creation, <Fuente>.CreationIfNotFound) and for opening the data file (<Source>.Open).
Encrypted files in an HFSQL connection: &nbspCaution: The order of use of functions for connecting to an HFSQL Client/Server database is important.. For more details, see Optimizing the connection times to the HFSQL Client/Server databases.

JDBC access: This function is not available for databases accessed via JDBC.

Ejemplo

// Open a data file with password and error check
Customer.Password("Password")
IF Customer.CreateIfNotFound() = False THEN
	Error("HFSQL error: " + HErrorInfo())
	RETURN
END
// <Source>.ErrorPassword is used to find out whether the error that occurred is a password error
IF Customer.CreateIfNotFound() = False THEN
	// Error details
	IF HErrorPassword() = True THEN
		Error("Invalid password")
		// Code to retry
	END
END

Sintaxis

<Result> = <Source>.Password([<Password>])

<Result>: Booleano

True if the password is saved,
False if an error occurred (insufficient memory for example). HError and HErrorInfo return more details about the problem.

<Source>: Tipo de fuente especificada

Name of data file that uses a password.
If the data file is declared with <Source>.DeclareExternal, <Source> corresponds to the name of the data file alias.

<Password>: Cadena de caracteres opcional

Password associated with the data file.
If this parameter is not specified or is an empty string (""), no password is defined for the data file. The password size is not limited.
Novedad versión 2025
Cadenas secretas: Si utiliza el almacén de cadenas secretas, el tipo de cadena secreta utilizado para este parámetro debe ser "ANSI o Unicode string".
Para obtener más información sobre las cadenas secretas y el almacén, consulte Almacén de cadenas secretas.
HFSQL data file password is case insensitive.

Observaciones

When to use <Source>.Password?

<Source>.Password must be called:

before explicit opening or creation functions: <Source>.Open, <Fuente>.Creation, <Fuente>.CreationIfNotFound.
before the HFSQL functions that access the date files and that automatically open the data files if not already done (read, search, add, ...).

Remarks:

If a password is specified in the explicit opening or creation functions (<Source>.Open, <Fuente>.Creation, <Fuente>.CreationIfNotFound), the password specified in <Source>.Password is ignored.
HFSQL data file passwords are case insensitive.
To change a password on an existing data file or add a password to a data file created without a password, you must use <Source>.ChangePassword.

Defining a password on a data file

A data file will be protected by password if:

<Source>.Password was used before the function for creating the data file (<Fuente>.Creation and <Fuente>.CreationIfNotFound),
or the password has been specified directly in the data file creation function.

Note A data file can be password-protected without being encrypted, and vice versa. The password is independent of data encryption. The data encryption must be configured during the file description in the data model editor ("Details" tab).

Deleting the password defined on a data file

To delete a password on a data file, an automatic data file modification must be performed.

To do so, perform a modification in the analysis (modify the size of an item for example). In this case, an automatic data file modification will be proposed when the analysis is generated. You will be able to modify or delete the password associated with one or more data files.

If your data files are already deployed, specify that an automatic data file modification is required when creating the setup program. The password will be deleted or modified.

Attention: if you remove the password from your data files, don't forget to adapt your code.

Managing passwords (OLE DB and Native Accesses)

The password must be specified in the parameters of the connection.

Clasificación Lógica de negocio / UI: Lógica de negocio

Componente: wd300hf.dll

Ver también

Versión mínima requerida

Versión 25

Esta página también está disponible para…

Comentarios

Haga clic en [Agregar] para publicar un comentario

Última modificación: 05/12/2024

Señalar un error o enviar una sugerencia | Ayuda local