Microsoft DirectX 8.1 (C++)

lstrcpynW

Copies a wide string to a buffer, up to a specified number of wide characters.

Syntax

LPWSTR lstrcpynW(
    LPWSTR lpszString1,
    LPCWSTR lpszString2,
    int iMaxLength
);

Parameters

lpszString1

Pointer to a buffer to receive the contents of the string that the lpszString2 parameter points to. The buffer must be large enough to contain the string, including the terminating wide null character.

lpszString2

Pointer to the null-terminated wide string to be copied.

iMaxLength

Maximum number of wide characters to copy, including a terminating null character.

Return Value

Returns a pointer to the buffer.

Remarks

If iMaxLength is nonzero, lstrcpynW always inserts a terminating null wide character in the destination string, which could result in the source string being truncated.

See Also