Função SHPathPrepareForWriteA (shlobj_core.h)
Verifica se o caminho existe. Isso inclui remontar unidades de rede mapeadas, solicitar que a mídia ejetável seja reinserida, criar os caminhos, solicitar que a mídia seja formatada e fornecer as interfaces de usuário apropriadas, se necessário. As permissões de leitura/gravação para o meio não são verificadas.
Sintaxe
SHSTDAPI SHPathPrepareForWriteA(
[in, optional] HWND hwnd,
[in, optional] IUnknown *punkEnableModless,
[in] LPCSTR pszPath,
DWORD dwFlags
);
Parâmetros
[in, optional] hwnd
Digite: HWND
Um identificador para uma janela que especifica a janela pai a ser usada para qualquer janela de interface do usuário que deve ser criada. Se definido como NULL, as janelas da interface do usuário não serão criadas.
[in, optional] punkEnableModless
Tipo: IUnknown*
Um ponteiro para uma interface IUnknown que especifica o objeto IOleInPlaceActiveObject que implementa o método EnableModeless .
[in] pszPath
Tipo: LPCTSTR
Um ponteiro para uma cadeia de caracteres terminada em nulo de comprimento máximo MAX_PATH que especifica o caminho a ser verificado como válido para gravação. Pode ser um caminho UNC ou de unidade de arquivo.
dwFlags
Tipo: DWORD
Sinalizadores que determinam opções de comportamento. Esse parâmetro pode ser uma combinação dos seguintes valores.
SHPPFW_NONE
Não crie novos diretórios.
SHPPFW_DEFAULT
Padrão. Não avisar o usuário se um diretório precisa ser criado. Isso é idêntico ao SHPPFW_DIRCREATE. Não passe com SHPPFW_ASKDIRCREATE.
SHPPFW_DIRCREATE
Crie diretórios sem avisar o usuário. Não passe com SHPPFW_ASKDIRCREATE.
SHPPFW_ASKDIRCREATE
Avisar o usuário antes de criar diretórios. Não passe com SHPPFW_DIRCREATE.
SHPPFW_IGNOREFILENAME
O último item no pszPath é um nome de arquivo, portanto, ignore. Por exemplo, se pszPath="C:\MyDir\MyFile.doc", use apenas "C:\MyDir". Se pszPath="C:\MyFirDir\MySecDir", use apenas "C:\MyFirDir".
SHPPFW_NOWRITECHECK
Não implementado atualmente.
SHPPFW_MEDIACHECKONLY
Windows XP ou posterior. Suprime a caixa de mensagem de erro "não acessível", que é exibida quando ocorre uma falha diferente de um cancelamento de usuário e hwnd não é NULL.
Valor retornado
Tipo: HRESULT
Retorna S_OK se o caminho estiver disponível, caso contrário, um código de erro. Observe que um valor retornado de S_OK não significa que o meio é gravável; isso simplesmente significa que o caminho está disponível.
Comentários
O uso principal dessa função é que um programa marcar um caminho antes de usá-lo e exibir a interface do usuário necessária para solicitar ao usuário. Por exemplo, se o disco na unidade A: estiver ausente, uma janela que solicita que o usuário insira o disco será exibida.
Observação
O cabeçalho shlobj_core.h define SHPathPrepareForWrite como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.
Requisitos
Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
Plataforma de Destino | Windows |
Cabeçalho | shlobj_core.h (inclua Shlobj.h, Shlobj_core.h) |
Biblioteca | Shell32.lib |
DLL | Shell32.dll (versão 5.0 ou posterior) |
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de