Función StrDupA (shlwapi.h)

Duplica una cadena.

Sintaxis

PSTR StrDupA(
  PCSTR pszSrch
);

Parámetros

pszSrch

Tipo: PCTSTR

Puntero a una constante cadena de caracteres terminadanull.

Valor devuelto

Tipo: PTSTR de

Devuelve la dirección de la cadena que se copió o NULL si no se puede copiar la cadena.

Observaciones

StrDup asignará almacenamiento al tamaño de la cadena original. Si la asignación de almacenamiento se realiza correctamente, la cadena original se copia en la cadena duplicada.

Esta función usa localAlloc para asignar espacio de almacenamiento para la copia de la cadena. La aplicación que realiza la llamada debe liberar esta memoria llamando a la función localFree en el puntero devuelto por la llamada a StrDup.

Ejemplos

Esta sencilla aplicación de consola muestra el uso de StrDup.

#include <windows.h>
#include <shlwapi.h>
#include <stdio.h>

void main(void)
{
   char buffer[] = "This is the buffer text";
   char *newstring;

   // Note: Never use an unbounded %s format specifier in printf.
   printf("Original: %25s\n", buffer);

   newstring = StrDup(buffer);
   if (newstring != NULL)
   {
       printf("Copy:     %25s\n", newstring);
       LocalFree(newstring);
   }
}

OUTPUT:
- - - - - - 
Original: This is the buffer text
Copy:     This is the buffer text

Nota

El encabezado shlwapi.h define StrDup 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 4.71 o posterior)