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 成員都設定為零。
• dwStringOffset 為非零， 而 dwStringSize 為零。
• dwStringOffset 為非零， dwStringSize 為 1，而指定位移的位元組為零。

需求

標頭	tapi.h