共用方式為

NPGetConnection3 函式 (npapi.h)

  • 發行項

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

語法

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

參數

[in] lpLocalName

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

[in] dwLevel

值，指定網路連線目前是否已連線或已中斷連線。

值 意義
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 會儲存連線資訊。

規格需求

需求 值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平台 Windows
標頭 npapi.h