SHPathPrepareForWriteA, fonction (shlobj_core.h)

Article
11/20/2024

Vérifie si le chemin existe. Cela inclut la remontage des lecteurs réseau mappés, l’invite à réinsérer les supports éjectables, à créer les chemins d’accès, à inviter le média à mettre en forme et à fournir les interfaces utilisateur appropriées, si nécessaire. Les autorisations en lecture/écriture pour le support ne sont pas vérifiées.

Syntaxe

SHSTDAPI SHPathPrepareForWriteA(
  [in, optional] HWND     hwnd,
  [in, optional] IUnknown *punkEnableModless,
  [in]           LPCSTR   pszPath,
                 DWORD    dwFlags
);

Paramètres

[in, optional] hwnd

Type : HWND

Handle vers une fenêtre qui spécifie la fenêtre parente à utiliser pour toutes les fenêtres d’interface utilisateur qui doivent être créées. Si la valeur est définie sur NULL, les fenêtres d’interface utilisateur ne sont pas créées.

[in, optional] punkEnableModless

Type : * IUnknown

Pointeur vers une interface IUnknown qui spécifie l’objet IOleInPlaceActiveObject qui implémente la méthode EnableModeless.

[in] pszPath

Type : LPCTSTR

Pointeur vers une chaîne terminée par null de longueur maximale MAX_PATH qui spécifie le chemin d’accès à vérifier comme valide pour l’écriture. Il peut s’agir d’un chemin d’accès de lecteur UNC ou de fichier.

dwFlags

Type : DWORD

Indicateurs qui déterminent les options de comportement. Ce paramètre peut être une combinaison des valeurs suivantes.

SHPPFW_NONE

Ne créez pas de répertoires.

SHPPFW_DEFAULT

Faire défaut. N’invitez pas l’utilisateur si un répertoire doit être créé. Cela est identique à SHPPFW_DIRCREATE. Ne passez pas avec SHPPFW_ASKDIRCREATE.

SHPPFW_DIRCREATE

Créez des répertoires sans inviter l’utilisateur. Ne passez pas avec SHPPFW_ASKDIRCREATE.

SHPPFW_ASKDIRCREATE

Invitez l’utilisateur avant de créer des répertoires. Ne passez pas avec SHPPFW_DIRCREATE.

SHPPFW_IGNOREFILENAME

Le dernier élément de pszPath est un nom de fichier, donc ignorer. Par exemple, si pszPath= »C:\MyDir\MyFile.doc« , utilisez uniquement « C :\MyDir ». Si pszPath="C :\MyFirDir\MySecDir », utilisez uniquement « C :\MyFirDir ».

SHPPFW_NOWRITECHECK

Non implémenté actuellement.

SHPPFW_MEDIACHECKONLY

Windows XP ou version ultérieure. Supprime la boîte de message d’erreur « non accessible », qui s’affiche lorsqu’une défaillance autre qu’une annulation de l’utilisateur se produit, et hwnd n’est pas NULL.

Valeur de retour

Type : HRESULT

Retourne S_OK si le chemin d’accès est disponible ou si un code d’erreur est différent. Notez qu’une valeur de retour de S_OK ne signifie pas que le support est accessible en écriture ; cela signifie simplement que le chemin d’accès est disponible.

Remarques

L’utilisation principale de cette fonction est qu’un programme vérifie un chemin avant de l’utiliser et affiche l’interface utilisateur nécessaire pour inviter l’utilisateur. Par exemple, si le disque du lecteur A était manquant, une fenêtre qui invite l’utilisateur à insérer le disque s’affiche.

Note

L’en-tête shlobj_core.h définit SHPathPrepareForWrite comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	shlobj_core.h (include Shlobj.h, Shlobj_core.h)
bibliothèque	Shell32.lib
DLL	Shell32.dll (version 5.0 ou ultérieure)

Partager via