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を返す必要があります。それ以外の場合は、次のいずれかのエラーコードを返す必要があります。

リターンコード	説明
WN_NOT_CONNECTED	lpLocalName で指定されたデバイスは、このプロバイダーによってリダイレクトされません。
WN_MORE_DATA	バッファーが小さすぎて、すべてのデータを受信できませんでした。
WN_NO_NETWORK	ネットワークが存在しません。

NPGetConnection 関数は、現在接続されているネットワーク接続に関する情報のみを返すことができます。現在切断されているネットワーク接続に関する情報を取得するには、 NPGetConnection3 を使用します。