VARSTRING 構造体 (tapi.h)

VARSTRING 構造体は、可変サイズの文字列を返す場合に使用されます。 これは、回線デバイス クラスと電話デバイス クラスの両方で使用されます。

構文

typedef struct varstring_tag {
  DWORD dwTotalSize;
  DWORD dwNeededSize;
  DWORD dwUsedSize;
  DWORD dwStringFormat;
  DWORD dwStringSize;
  DWORD dwStringOffset;
} VARSTRING, *LPVARSTRING;

メンバー

dwTotalSize

このデータ構造に割り当てられた合計サイズ (バイト単位)。

dwNeededSize

返されるすべての情報を保持するために必要なこのデータ構造のサイズ (バイト単位)。

dwUsedSize

有用な情報を含むこのデータ構造の部分のサイズ (バイト単位)。

dwStringFormat

文字列の形式。 このメンバーは、 STRINGFORMAT_定数のいずれかを使用します。

dwStringSize

null 終端記号を含む文字列情報のサイズ (バイト単位)。

dwStringOffset

構造体の先頭から、文字列情報を含む可変サイズのデバイス フィールドまでのオフセット。 フィールドのサイズは dwStringSize で指定します。

解説

機能拡張なし。

変数構造体で文字列を返すことができない場合、 dwStringSize メンバーと dwStringOffset メンバーは次のいずれかの方法で設定されます。

• dwStringSize メンバーと dwStringOffset メンバーはどちらも 0 に設定されます。
• dwStringOffset は 0 以外で、 dwStringSize は 0 です。
• dwStringOffset は 0 以外、 dwStringSize は 1、指定されたオフセットのバイトは 0 です。

必要条件

Header	tapi.h