共用方式為

NPGetConnection3 函式 （npapi.h）

擷取網路連線的相關信息，即使目前已中斷連線也一樣。

語法

DWORD NPGetConnection3(
  [in]      LPCWSTR lpLocalName,
  [in]      DWORD   dwLevel,
  [out]     LPVOID  lpBuffer,
  [in, out] LPDWORD lpBufferSize
);

參數

[in] lpLocalName

呼叫端感興趣的本機裝置名稱的指標。 提供者可以假設這在語法上有效。

[in] dwLevel

指定網路連線目前是已連線還是已中斷連線的值。

價值觀 Meaning
WNGETCON_CONNECTED
 網路連線已連線。
WNGETCON_DISCONNECTED
 網路連線已中斷。

[out] lpBuffer

Void 指標，接收包含所要求資訊的緩衝區。

[in, out] lpBufferSize

lpBuffer 緩衝區大小的指標 （以字元為單位）。 如果呼叫因為緩衝區不夠大而失敗，則 lpBufferSize 會設定為所需的緩衝區大小。

返回值

如果函式成功，它應該會傳回WN_SUCCESS。

如果函式失敗，它應該傳回下列其中一個值。

回傳碼 Description
WN_NOT_CONNECTED
 lpLocalName 所指定的裝置不會由此提供者重新導向。
WN_MORE_DATA
 緩衝區太小，無法接收所有資料。
WN_NO_NETWORK
 網路不存在。

備註

網路連線可以存在三種狀態：已連線、已中斷連線和無法使用。 NPGetConnection3 函式無法擷取目前無法使用的網路連線相關資訊。 不過，它可以擷取目前已中斷連線的網路連線相關資訊，因為 Windows 會儲存連線資訊。

需求

Requirement 價值觀
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
支援的最低伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平臺 窗戶
Header npapi.h
Library nanosrv.lib
  • Last updated on