NPGetConnection 函式 (npapi.h)

擷取連線的相關資訊。

語法

DWORD NPGetConnection(
  [in]      LPWSTR  lpLocalName,
  [out]     LPWSTR  lpRemoteName,
  [in, out] LPDWORD lpnBufferLen
);

[in] lpLocalName

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

[out] lpRemoteName

將接收用來建立連線之遠端名稱之緩衝區的指標。呼叫端會配置此緩衝區。

[in, out] lpnBufferLen

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

如果函式成功，它應該會傳回WN_SUCCESS。否則，它應該會傳回錯誤碼，可能是下列其中一項：

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

NPGetConnection 函式只能傳回目前已連線之網路連線的相關信息。若要擷取目前已中斷連線之網路連線的相關信息，請使用 NPGetConnection3。