次の方法で共有

BluetoothGATTBeginReliableWrite 関数 (bluetoothleapis.h)

  • [アーティクル]

BluetoothGATTBeginReliableWrite 関数は、信頼性の高い書き込みが開始されることを指定します。

構文

HRESULT BluetoothGATTBeginReliableWrite(
  [in]  HANDLE                              hDevice,
  [out] PBTH_LE_GATT_RELIABLE_WRITE_CONTEXT ReliableWriteContext,
  [in]  ULONG                               Flags
);

パラメーター

[in] hDevice

サービスへのハンドル。

[out] ReliableWriteContext

信頼できる書き込み操作を記述するコンテキストを含む BTH_LE_GATT_RELIABLE_WRITE_CONTEXT 構造体のアドレス。

[in] Flags

BluetoothGATTBeginReliableWrite の動作を変更するためのフラグ:

フラグ 説明
BLUETOOTH_GATT_FLAG_NONE クライアントに特定の GATT 要件がありません (既定値)。

戻り値

BluetoothGATTBeginReliableWrite 関数は、次の値を返します。

リターン コード 説明
S_OK
 操作は正常に完了しました。
ERROR_ACCESS_DENIED
 親サービスとサービス ハンドルの両方が提供され、サービス階層が指定された親サービス ハンドルにロールアップされない場合に返されます。
ERROR_INVALID_FUNCTION
 現在、信頼性の高い書き込み操作が進行中です。

注釈

BluetoothGATTBeginReliableWrite 関数は、関数が返された後に呼び出されるプロシージャが信頼性の高い書き込み操作であることを Bluetooth スタックに通知します。 信頼できる書き込みをサポートしていない操作は、 ERROR_INVALID_FUNCTION エラーを返します。 信頼できる書き込み操作をサポートするのは、次の関数のみです。

例


BTH_LE_GATT_RELIABLE_WRITE_CONTEXT ReliableWriteContext = NULL;
hr = BluetoothGATTBeginReliableWrite(hDevice, 
                                    &ReliableWriteContext,
                                    BLUETOOTH_GATT_FLAG_NONE);

if (SUCCEEDED(hr)) {
    // Calls to BluetoothGATTSetCharacteristicValue
}

if (NULL != ReliableWriteContext) {
    BluetoothGATTEndReliableWrite(hDevice, 
                                 ReliableWriteContext,
                                  BLUETOOTH_GATT_FLAG_NONE);
}

要件

要件 値
サポートされている最小のクライアント Windows 8 以降のバージョンの Windows でサポートされています。
対象プラットフォーム ユニバーサル
Header bluetoothleapis.h
Library BluetoothAPIs.lib
[DLL] BluetoothAPIs.dll