Function

GLibWin32get_package_installation_subdirectory

deprecated: 2.18 

Declaration [src] 

gchar*
g_win32_get_package_installation_subdirectory (
  const gchar* package,
  const gchar* dll_name,
  const gchar* subdir
)

Description [src]

This function is deprecated. Use g_win32_get_package_installation_directory_of_module() and g_build_filename() instead.

Returns a newly-allocated string containing the path of the subdirectory subdir in the return value from calling g_win32_get_package_installation_directory() with the package and dll_name parameters. See the documentation for g_win32_get_package_installation_directory() for more details. In particular, note that it is deprecated to pass anything except NULL as package.

Deprecated since: 2.18

Pass the HMODULE of a DLL or EXE to g_win32_get_package_installation_directory_of_module() instead, and then construct a subdirectory pathname with g_build_filename().

Parameters

package

Type: const gchar*

You should pass NULL for this.

The argument can be NULL.
The data is owned by the caller of the function.
The value is a NUL terminated UTF-8 string.
dll_name

Type: const gchar*

The name of a DLL that a package provides, in UTF-8, or NULL.

The argument can be NULL.
The data is owned by the caller of the function.
The value is a NUL terminated UTF-8 string.
subdir

Type: const gchar*

A subdirectory of the package installation directory, also in UTF-8.

The data is owned by the caller of the function.
The value is a NUL terminated UTF-8 string.

Return value

Type: gchar*

A string containing the complete path to subdir inside the installation directory of package. The returned string is in the GLib file name encoding, i.e. UTF-8. The return value should be freed with g_free() when no longer needed. If something goes wrong, NULL is returned.

The caller of the function takes ownership of the data, and is responsible for freeing it.
The value is a NUL terminated UTF-8 string.