/ 
Win32API-RecentFiles-0.04
River stage zero No dependents
/ Win32API::RecentFiles

NAME

Win32API::RecentFiles - recently accessed file API functions on Windows

SYNOPSIS

use Win32API::RecentFiles qw(SHAddToRecentDocsA SHAddToRecentDocsW SHAddToRecentDocsU);
use Win32;
use Encode 'encode';
SHAddToRecentDocsA('C:\\Full\\Path\\To\\Makefile.PL');
SHAddToRecentDocsW(encode('UTF-16LE', 'C:\\Full\\Path\\To\\Motörhead.mp3'));

use utf8;
SHAddToRecentDocsU('C:\\Full\\Path\\To\\fünf.txt');
my $recent_dir = Win32::GetFolderPath(Win32::CSIDL_RECENT());
# $recent_dir\\fünf.txt.lnk exists

DESCRIPTION

This module exports the SHAddToRecentDocsA SHAddToRecentDocsU and SHAddToRecentDocsW functions.

FUNCTIONS

SHAddToRecentDocsA

SHAddToRecentDocsA('C:\\Full\\Path\\To\\Makefile.PL');

Adds the filename to the list of recently accessed documents. $filename must be an ANSI string encoded in the local code page. Relative paths will be evaluated against the current directory.

SHAddToRecentDocsU

SHAddToRecentDocsU('C:\\Full\\Path\\To\\Makefile.PL');

$filename must be a Unicode string encoded as UTF-8.

SHAddToRecentDocsW

SHAddToRecentDocsW('C\0:\0\\\0...');

$filename must be a sequence of bytes encoded as UTF-16.

CYGWIN

Programs under Cygwin need to take care to pass native Windows filenames and paths with Backslashes (!) tto the API.

SEE ALSO

Microsoft documentation at https://learn.microsoft.com/de-de/windows/win32/api/shlobj_core/nf-shlobj_core-shaddtorecentdocs

REPOSITORY

The public repository of this module is https://github.com/Corion/Win32API-RecentFiles.

SUPPORT

The public support forum of this module is https://perlmonks.org/.

BUG TRACKER

Please report bugs in this module via the Github bug queue at https://github.com/Corion/Win32API-RecentFiles/issues

AUTHOR

Max Maischein corion@cpan.org

COPYRIGHT (c)

Copyright 2024- by Max Maischein corion@cpan.org.

LICENSE

This module is released under the Artistic License 2.0.