Función SHStrDupA (shlwapi.h)

Realiza una copia de una cadena en la memoria recién asignada.

Sintaxis

LWSTDAPI SHStrDupA(
  [in]  LPCSTR psz,
  [out] LPWSTR *ppwsz
);

Parámetros

[in] psz

Tipo: LPCTSTR de

Puntero a la cadena terminada en null que se va a copiar.

[out] ppwsz

Tipo: LPTSTR*

Puntero a una cadena Unicode asignada que contiene el resultado. SHStrDup asigna memoria para esta cadena con CoTaskMemAlloc. Debe liberar la cadena con CoTaskMemFree cuando ya no sea necesario.

En caso de error, este valor es NULL.

Valor devuelto

Tipo: HRESULT

Devuelve S_OK si se ejecuta correctamente o un valor de error COM de lo contrario.

Observaciones

Esta función tomará cadenas Unicode o ANSI como entrada, pero la cadena copiada siempre es Unicode.

Esta función usa CoTaskMemAlloc para asignar memoria a la cadena copiada. Debe liberar esta memoria con CoTaskMemFree cuando ya no sea necesario.

Nota

El encabezado shlwapi.h define SHStrDup como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	shlwapi.h
biblioteca de	Shlwapi.lib
DLL de	Shlwapi.dll (versión 5.0 o posterior)

Consulte también

StrDup