Str_GetPtr関数
[この機能は、Service Pack 2 (SP2) と Windows Server 2003 を使用した Windows XP を通じて使用できます。 以降のバージョンの Windows では変更または使用できない場合があります。]
あるバッファーから別のバッファーに文字列をコピーします。
構文
int WINAPI Str_GetPtr(
_In_ LPCTSTR pszSource,
_Inout_ LPCSTR pszDest,
_In_ int cchDest
);
パラメーター
-
pszSource [in]
-
型: LPCTSTR
ソース文字列へのポインター。
-
pszDest [in, out]
-
種類: LPCSTR
宛先バッファーへのポインター。 この値は NULL にすることができます。
-
cchDest [in]
-
型: int
pszDest のサイズ (文字単位)。
戻り値
型: int
pszDest が NULL または cchDest が 0 の場合、pszSource が指す文字列の null で終わるコピーを格納するために必要なバッファーのサイズを文字数で返します。
pszDest が NULL 以外の場合は、正常にコピーされた文字数 (終端の null 文字を含む) を返します。
pszDest が指す文字列全体を pszSource で保持できない場合は、(cchDest-1) 文字がコピーされ、文字列は null で終わる、cchDest が返されます。
解説
Str_GetPtr は ANSI (Str_GetPtrA) および Unicode (Str_GetPtrW) バージョンとして使用できます。 これらの関数は、名前によってエクスポートされたり、パブリック ヘッダー ファイルで宣言されたりしません。 これらを使用するには、 GetProcAddress を使用し、ComCtl32.dllから序数 233 (Str_GetPtrA) または 235 (Str_GetPtrW) を要求して関数ポインターを取得する必要があります。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント |
Windows Vista [デスクトップ アプリのみ] |
サポートされている最小のサーバー |
Windows Server 2003 [デスクトップ アプリのみ] |
[DLL] |
|
Unicode 名と ANSI 名 |
Str_GetPtrW (Unicode) と Str_GetPtrA (ANSI) |