Função SHLocalStrDupW (shlwapi.h)

Artigo
11/20/2024

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 de retorno

Tipo: HRESULT

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Observações

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2008 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	shlwapi.h

Compartilhar via