ci(client-cpp): link-test example after Windows VS package builds

Author: hongzhi-gao

.github/scripts/verify-client-cpp-example-windows.sh

@@ -0,0 +1,70 @@
+#!/usr/bin/env bash
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with this
+# work for additional information regarding copyright ownership.  The ASF
+# licenses this file to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance with the
+# License.  You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# Link-test example/client-cpp-example against a freshly built Windows SDK install
+# tree, using the same Visual Studio generator as the package job (CMAKE_GENERATOR).
+set -euxo pipefail
+
+cd "${GITHUB_WORKSPACE:?GITHUB_WORKSPACE is not set}"
+
+SDK="${GITHUB_WORKSPACE}/iotdb-client/client-cpp/target/install"
+EXAMPLE_SRC="${GITHUB_WORKSPACE}/example/client-cpp-example/src"
+BUILD_DIR="${GITHUB_WORKSPACE}/build/client-cpp-example-verify"
+rm -rf "${BUILD_DIR}"
+
+test -f "${SDK}/lib/iotdb_session.dll"
+test -f "${SDK}/lib/iotdb_session.lib"
+
+GEN_ARGS=()
+if [[ -n "${CMAKE_GENERATOR:-}" ]]; then
+  GEN_ARGS=(-G "${CMAKE_GENERATOR}")
+fi
+
+echo "=== Link-test client-cpp-example (Windows / same VS generator) ==="
+if [[ ${#GEN_ARGS[@]} -gt 0 ]]; then
+  echo "CMAKE_GENERATOR=${CMAKE_GENERATOR}"
+else
+  echo "CMAKE_GENERATOR=(default for runner)"
+fi
+cmake --version | head -1
+
+cmake -S "${EXAMPLE_SRC}" -B "${BUILD_DIR}" \
+  "${GEN_ARGS[@]}" \
+  -A x64 \
+  -DIOTDB_SDK_ROOT="${SDK}" \
+  -DWITH_SSL=OFF
+
+cmake --build "${BUILD_DIR}" --config Release --target SessionExample --parallel
+
+EXE="${BUILD_DIR}/Release/SessionExample.exe"
+DLL="${BUILD_DIR}/Release/iotdb_session.dll"
+test -f "${EXE}"
+test -f "${DLL}"
+
+# Guard against accidental Win32 builds.
+python3 - <<'PY' "${EXE}"
+import struct, sys
+path = sys.argv[1]
+with open(path, "rb") as f:
+    data = f.read()
+pe_off = struct.unpack_from("<I", data, 0x3C)[0]
+machine = struct.unpack_from("<H", data, pe_off + 4)[0]
+if machine != 0x8664:
+    raise SystemExit(f"Expected PE32+ x64 (0x8664), got 0x{machine:04X}")
+print(f"Verified x64 executable: {path}")
+PY
+
+echo "client-cpp-example SessionExample link test passed (Windows)"

.github/workflows/client-cpp-package.yml

@@ -60,6 +60,7 @@ jobs:
               - '.github/workflows/client-cpp-package.yml'
               - '.github/workflows/client-cpp-source-build.yml'
               - '.github/scripts/package-client-cpp-*.sh'
+              - '.github/scripts/verify-client-cpp-example-*.sh'
       - id: result
         shell: bash
         run: |
@@ -409,6 +410,14 @@ jobs:
             throw "Expected PE32+ x64 (machine=0x8664), got 0x$($machine.ToString('X4'))"
           }
           Write-Host "Verified x64 DLL: $dll"
+      - name: Link-test client-cpp-example (same VS toolchain)
+        shell: bash
+        env:
+          CMAKE_GENERATOR: ${{ matrix.cmake_generator }}
+        run: |
+          set -euxo pipefail
+          chmod +x .github/scripts/verify-client-cpp-example-windows.sh
+          .github/scripts/verify-client-cpp-example-windows.sh
       - name: Resolve package zip
         id: pkg
         shell: bash

iotdb-client/client-cpp/README.md

@@ -101,9 +101,12 @@ Example file name:
 when linking.
 
 CI runs an extra check after packaging: build `SessionExample` from
-`example/client-cpp-example` inside the same manylinux2014 container using
-**system `/usr/bin/g++`** (no devtoolset on `PATH`) against the freshly built
-SDK install tree, then prints `ldd` output.
+`example/client-cpp-example` against the freshly built SDK install tree.
+
+- **Linux glibc217**: inside manylinux2014 with **system `/usr/bin/g++`**
+  (no devtoolset on `PATH`), then `ldd`.
+- **Windows**: same **Visual Studio generator** as the package matrix entry
+  (see `.github/scripts/verify-client-cpp-example-windows.sh`).
 
 Thrift **0.21.0** is compiled from source during the CMake configure step (see
 `cmake/FetchThrift.cmake`). Older releases that used pre-built