次の方法で共有

TcRegisterClient 関数 (traffic.h)

TcRegisterClient 関数は、トラフィック制御インターフェイス (TCI) にクライアントを登録するために使用されます。 TcRegisterClient 関数は、クライアントが TCI に対して行う最初の関数呼び出しである必要があります。

クライアント登録は、TCI がクライアントによって開始された操作または非同期イベントを完了できるようにするコールバック ルーチンを提供します。 登録が成功したら、 TcRegisterClient 関数の呼び出し元が TCI ハンドラーを呼び出す準備ができている必要があります。 詳細については、「 トラフィック 制御インターフェイスのクライアントによって公開されるエントリ ポイント 」を参照してください。

構文

ULONG TcRegisterClient(
  [in]  ULONG                 TciVersion,
  [in]  HANDLE                ClRegCtx,
  [in]  PTCI_CLIENT_FUNC_LIST ClientHandlerList,
  [out] PHANDLE               pClientHandle
);

パラメーター

[in] TciVersion

トラフィック制御とクライアント間の互換性を確保するために、クライアントで想定されるトラフィック制御バージョンが含まれています。 クライアントは Traffic.h で定義されたCURRENT_TCI_VERSIONを渡すことができます。

[in] ClRegCtx

クライアント登録コンテキスト。 クライアントの通知ハンドラー関数が呼び出されると、ClRegCtx が返されます。 これは、インターフェイスのこのインスタンスの任意のクライアント定義コンテキストを保持するコンテナーにすることができます。

[in] ClientHandlerList

クライアントが提供するハンドラーの一覧へのポインター。 クライアント提供のハンドラーは、通知イベントと非同期入力候補に使用されます。 通知ハンドラーを除き、各完了ルーチンは省略可能です。 通知ハンドラーを NULL に設定すると、ERROR_INVALID_PARAMETERが返されます。

[out] pClientHandle

トラフィック 制御がクライアントに登録ハンドルを返すために使用するバッファーへのポインター。

戻り値

リターン コード 説明
NO_ERROR
 エラーなしで実行された関数。
ERROR_NOT_ENOUGH_MEMORY
 システムがメモリ不足です。
ERROR_INVALID_PARAMETER
 パラメーターの 1 つが NULL です。
ERROR_INCOMPATIBLE_TCI_VERSION
 TCI のバージョンが間違っています。
ERROR_OPEN_FAILED
 トラフィック制御でシステム デバイスを開けませんでした。 原因として、特権が不足している可能性があります。
ERROR_TOO_MANY_CLIENTS
 トラフィック制御をカーネル コンポーネントの GPC に登録できませんでした。 原因として考えられるのは、現在接続されているトラフィック制御クライアントが多すぎる場合です。

Windows 2000: この値はサポートされていません。

注釈

戻りコードの一部は tcerror.h にあります。

メモTcRegisterClient 関数を使用するには、管理特権が必要です。
 

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー traffic.h
Library Traffic.lib
[DLL] Traffic.dll