Fungsi StrDupW (shlwapi.h)

Menduplikasi string.

Sintaksis

PWSTR StrDupW(
  PCWSTR pszSrch
);

Parameter

pszSrch

Jenis: PCTSTR

Penunjuk ke konstanta string karakter nulldihentikan.

Mengembalikan nilai

Jenis: PTSTR

Mengembalikan alamat string yang disalin, atau NULL jika string tidak dapat disalin.

Komentar

StrDup akan mengalokasikan penyimpanan ukuran string asli. Jika alokasi penyimpanan berhasil, string asli disalin ke string duplikat.

Fungsi ini menggunakan LocalAlloc untuk mengalokasikan ruang penyimpanan untuk salinan string. Aplikasi panggilan harus membebaskan memori ini dengan memanggil fungsi LocalFree pada pointer yang dikembalikan oleh panggilan ke StrDup.

Contoh

Aplikasi konsol sederhana ini menggambarkan penggunaanStrDup .

#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

Persyaratan