IESP：：QueryStatus 方法

  • 發行項

QueryStatus方法會擷取 NPP 狀態。

語法

HRESULT STDMETHODCALLTYPE QueryStatus(
  [out] NETWORKSTATUS *pNetworkStatus
);

參數

pNetworkStatus [out]

傳回 之 NETWORKSTATUS 結構的指標，表示 NPP 的目前狀態 (擷取、暫停、停止) 等等。 使用者必須配置並釋放 NETWORKSTATUS 結構的記憶體。

傳回值

如果方法成功，傳回值會NMERR_SUCCESS。

如果方法失敗，傳回值會是下列錯誤碼：

傳回碼 Description
NMERR_INVALID_PARAMETER
 pNetworkStatus參數未指向有效的NETWORKSTATUS結構。 配置此結構的記憶體，並再次呼叫 IESP：：QueryStatus 。

備註

呼叫 CreateNPPInterface 之後，您可以隨時呼叫這個方法。 您可以呼叫這個方法來查看 NPP 是否已連線到網路、找出目前擷取的狀態，以及查看是否有任何觸發程式擱置中。

呼叫這個方法之前，請先配置 NETWORKSTATUS 結構所需的記憶體，並在不再需要結構時釋放該記憶體。

規格需求

需求 值
最低支援的用戶端
 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器
 Windows 2000 Server [僅限桌面應用程式]
標頭
Netmon.h
DLL
Ndisnpp.dll;
Rmtnpp.dll

另請參閱

IESP

CreateNPPInterface

NETWORKSTATUS