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 を使用します。

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー npapi.h