SHStrDupW 関数 (shlwapi.h)
新しく割り当てられたメモリ内の文字列のコピーを作成します。
構文
LWSTDAPI SHStrDupW(
[in] LPCWSTR psz,
[out] LPWSTR *ppwsz
);
パラメーター
[in] psz
種類: LPCTSTR
コピーする null で終わる文字列へのポインター。
[out] ppwsz
種類: LPTSTR*
結果を含む割り当てられた Unicode 文字列へのポインター。 SHStrDup は 、CoTaskMemAlloc を使用してこの文字列にメモリを割り当てます。 不要になった場合は、 CoTaskMemFree を使用して文字列を解放する必要があります。
エラーの場合、この値は NULL です。
戻り値
型: HRESULT
成功した場合はS_OKを返し、それ以外の場合は COM エラー値を返します。
注釈
この関数は Unicode または ANSI 文字列を入力として受け取りますが、コピーされた文字列は常に Unicode です。
この関数は、コピーした文字列のメモリを割り当てるために CoTaskMemAlloc を使用します。 不要になった場合は 、CoTaskMemFree を使用してこのメモリを解放する必要があります。
注意
shlwapi.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして SHStrDup を定義します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional、Windows XP [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | shlwapi.h |
| Library | Shlwapi.lib |
| [DLL] | Shlwapi.dll (バージョン 5.0 以降) |