IStats::QueryStatus メソッド
QueryStatus メソッドは、NPP の状態を取得します。
構文
HRESULT STDMETHODCALLTYPE QueryStatus(
[out] NETWORKSTATUS *pNetworkStatus
);
パラメーター
-
pNetworkStatus [out]
-
NPP の現在の状態 (キャプチャ、一時停止、停止など) を示す返された NETWORKSTATUS 構造体へのポインター。 NETWORKSTATUS 構造体のメモリを割り当てて解放するのは、アプリケーションの責任です。
戻り値
メソッドが成功した場合、戻り値はNMERR_SUCCESS。
メソッドが失敗した場合、戻り値は次のエラー コードになります。
リターン コード | 説明 |
---|---|
|
pNetworkStatus パラメーターが有効な NETWORKSTATUS 構造体を指していません。 この構造体にメモリを割り当て、 IStats::QueryStatus メソッドをもう一度呼び出します。 |
注釈
このメソッドは、 CreateNPPInterface メソッドが呼び出された後、いつでも呼び出すことができます。 NPP がネットワークに接続されているかどうかを確認し、現在のキャプチャの状態を確認し、トリガーが保留中かどうかを確認するために呼び出すことができます。 ただし、このメソッドを呼び出す前に、 NETWORKSTATUS 構造体に必要なメモリを割り当て、構造体が不要になったときにそのメモリを解放する必要があります。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント |
Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされている最小のサーバー |
Windows 2000 Server [デスクトップ アプリのみ] |
ヘッダー |
|
[DLL] |
|