lstrcpyn

Declare Function Api_lstrcpyn& Lib "kernel32" Alias "lstrcpynA" (ByVal lpString1$, ByVal lpString2$, ByVal iMaxLength&)

Declare Function lstrcpyn Lib "kernel32" Alias "lstrcpynA" (ByVal lpString1 As String, ByVal lpString2 As String, ByVal iMaxLength As Long) As Long

バッファにソース文字列から指定した数の文字をコピーする。

パラメータ
lpString1
    1 個のバッファへのポインタを指定する。関数から制御が返ると、このバッファに、文字列が格納される。

    このバッファは、終端の NULL 文字も含め、iMaxLength パラメータで指定した TCHAR の数の文字を格納するための十分なサイズでな

    ければならない。
lpString2
    コピー元となる、NULL で終わる文字列へのポインタを指定する。
iMaxLength
    lpString2 パラメータが指す文字列から、lpString1 パラメータが指すバッファへコピーするべき文字の数を TCHAR 単位で指定する。

    終端の NULL 文字分も含める。
　

戻り値
    関数が成功すると、バッファへのポインタが返る。これは、lpString1 パラメータと同じ値である。
    関数が失敗すると、NULL が返る。拡張エラー情報を取得するには、GetLastError 関数を使う。

解説
    パラメータが指すバッファが、終端の NULL 文字も含め、iMaxLength パラメータで指定した TCHAR の数の文字を格納するための十分

    なサイズでなければならないことに注意すること。