StringCchGetsW 関数 (strsafe.h)

  • [アーティクル]

改行文字 ('\n') まで、stdin から 1 行のテキストを取得します。 テキスト行がコピー先バッファーにコピーされ、改行文字が null 文字に置き換えられます。 コピー先バッファーのサイズは、 関数に提供され、このバッファーの末尾を越えて書き込まれないことを確認します。

メモ この関数はインラインでのみ使用できます。
 
StringCchGets は、次の関数に代わる関数です。 StringCchGets は fget の代わりではありません。改行文字は終端の null 文字に置き換えられません。

構文

STRSAFEAPI StringCchGetsW(
  [out] STRSAFE_LPWSTR pszDest,
  [in]  size_t         cchDest
);

パラメーター

[out] pszDest

種類: LPTSTR

コピーされた文字を受け取る宛先バッファー。

[in] cchDest

種類: size_t

変換先バッファーのサイズ (文字単位)。 関数を成功させるには、この値は少なくとも 2 である必要があります。 許容される最大文字数 (終端の null 文字を含む) は STRSAFE_MAX_CCH。 cchDest が小さすぎてテキスト行全体を保持できる場合、データは切り捨てられます。

戻り値

種類: HRESULT

この関数は、次のいずれかの値を返すことができます。 SUCCEEDED マクロと FAILED マクロを使用して、この関数の戻り値をテストすることを強くお勧めします。

リターン コード 説明
S_OK
 文字は stdin から読み取られ、 pszDest でバッファーにコピーされ、バッファーは null で終了しました。
STRSAFE_E_END_OF_FILE
 エラーまたはファイルの終了条件を示します。 feof または ferror を使用して、どれが発生したかを判断します。
STRSAFE_E_INVALID_PARAMETER
 cchDest の値が、許容される最大値を超えています。
STRSAFE_E_INSUFFICIENT_BUFFER
 cchDest の値は 1 以下です。
 

この関数は、置き換える関数とは異なり、 HRESULT 値を返します。

注釈

StringCchGets は、 コード内で適切なバッファー処理を行うための追加の処理を提供します。 バッファー処理の不十分さは、バッファー オーバーランを伴う多くのセキュリティの問題に関係しています。 StringCchGets は 、常に 0 以外の長さの宛先バッファーを null で終了します。

pszDest の値を NULL にすることはできません。 null 文字列ポインター値の処理が必要な場合は、「 StringCchGetsEx 」を参照してください。

StringCchGets は、汎用的な形式またはより具体的な形式で使用できます。 次の表に示すように、文字列のデータ型によって、使用する必要があるこの関数の形式が決まります。

文字列型 (String) リテラル文字列 機能
char "string" StringCchGetsA
TCHAR TEXT("string") StringCchGets
Wchar L"string" StringCchGetsW
 

注意

strsafe.h ヘッダーは StringCchGets をエイリアスとして定義します。このエイリアスは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

要件 値
サポートされている最小のクライアント WINDOWS XP と SP2 [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー Windows Server 2003 SP1 [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム Windows
ヘッダー strsafe.h

関連項目

参照

StringCbGets

StringCchGetsEx