Função SHStrDupW (shlwapi.h)
Faz uma cópia de uma cadeia de caracteres na memória recém-alocada.
Sintaxe
LWSTDAPI SHStrDupW(
[in] LPCWSTR psz,
[out] LPWSTR *ppwsz
);
Parâmetros
[in] psz
Tipo: LPCTSTR
Um ponteiro para a cadeia de caracteres terminada em nulo a ser copiada.
[out] ppwsz
Tipo: LPTSTR*
Um ponteiro para uma cadeia de caracteres Unicode alocada que contém o resultado. SHStrDup aloca memória para essa cadeia de caracteres com CoTaskMemAlloc. Você deve liberar a cadeia de caracteres com CoTaskMemFree quando ela não for mais necessária.
No caso de falha, esse valor é NULL.
Retornar valor
Tipo: HRESULT
Retorna S_OK se tiver êxito ou um valor de erro COM, caso contrário.
Comentários
Essa função usará cadeias de caracteres Unicode ou ANSI como entrada, mas a cadeia de caracteres copiada sempre é Unicode.
Essa função usa CoTaskMemAlloc para alocar memória para a cadeia de caracteres copiada. Você deve liberar essa memória com CoTaskMemFree quando ela não for mais necessária.
Observação
O cabeçalho shlwapi.h define SHStrDup 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
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Windows 2000 Professional, Windows XP [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 | shlwapi.h |
Biblioteca | Shlwapi.lib |
DLL | Shlwapi.dll (versão 5.0 ou posterior) |
Confira também
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