Struktur VARSTRING (tapi.h)

  • Artikel

Struktur VARSTRING digunakan untuk mengembalikan string berukuran varian. Ini digunakan baik oleh kelas perangkat baris maupun kelas perangkat telepon.

Sintaks

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

Anggota

dwTotalSize

Ukuran total yang dialokasikan untuk struktur data ini, dalam byte.

dwNeededSize

Ukuran untuk struktur data ini yang diperlukan untuk menyimpan semua informasi yang dikembalikan, dalam byte.

dwUsedSize

Ukuran bagian dari struktur data ini yang berisi informasi yang berguna, dalam byte.

dwStringFormat

Format string. Anggota ini menggunakan salah satu konstanta STRINGFORMAT_.

dwStringSize

Ukuran informasi string, termasuk terminator null , dalam byte.

dwStringOffset

Offset dari awal struktur ke bidang perangkat berukuran varian yang berisi informasi string. Ukuran bidang ditentukan oleh dwStringSize.

Keterangan

Tidak ada ekstensibilitas.

Jika string tidak dapat dikembalikan dalam struktur variabel, anggota dwStringSize dan dwStringOffset diatur dengan salah satu cara berikut:

  • Anggota dwStringSize dan dwStringOffset keduanya diatur ke nol.
  • dwStringOffset nonzero dan dwStringSize adalah nol.
  • dwStringOffset nonzero, dwStringSize adalah 1, dan byte pada offset yang diberikan adalah nol.

Persyaratan

   
Header tapi.h