Função SHLocalStrDupW (shlwapi.h)
Faz uma cópia de uma cadeia de caracteres na memória recém-alocada.
Sintaxe
HRESULT SHLocalStrDupW(
PCWSTR psz,
[out, optional] PWSTR *ppsz
);
Parâmetros
psz
Tipo: PCTSTR
Um ponteiro para uma cadeia de caracteres Unicode terminada em nulo a ser copiada.
[out, optional] ppsz
Tipo: PTSTR*
O endereço de um ponteiro para uma cadeia de caracteres alocada que, quando essa função retorna com êxito, recebe o resultado. SHLocalStrDup aloca memória para essa cadeia de caracteres com LocalAlloc. Você deve liberar a cadeia de caracteres com LocalFree quando ela não for mais necessária.
Valor retornado
Tipo: HRESULT
Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.
Comentários
Observação
O cabeçalho shlwapi.h define SHLocalStrDup 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 Vista [somente aplicativos da área de trabalho] |
Servidor mínimo com suporte | Windows Server 2008 [somente aplicativos da área de trabalho] |
Plataforma de Destino | Windows |
Cabeçalho | shlwapi.h |
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