IStats：：QueryStatus 方法

QueryStatus方法會擷取 NPP 的狀態。

語法

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

pNetworkStatus [out]: 傳回之 NETWORKSTATUS 結構的指標，指出 NPP 的目前狀態 (擷取、暫停、停止) 等等。應用程式必須負責配置和釋放 NETWORKSTATUS 結構的記憶體。

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

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

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

呼叫 CreateNPPInterface 方法之後，您可以隨時呼叫這個方法。您可以呼叫以查看 NPP 是否已連線到網路、找出目前擷取的狀態，以及查看是否有任何觸發程式擱置中。不過，呼叫此方法之前，您必須配置 NETWORKSTATUS 結構所需的記憶體，並在不再需要結構時釋放該記憶體。