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を返す必要があります。

関数が失敗した場合は、次のいずれかの値が返されます。

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

注釈

ネットワーク接続は、接続済み、切断済み、使用不可の 3 つの状態で存在できます。 NPGetConnection3 関数は、現在使用できないネットワーク接続に関する情報を取得できません。 ただし、Windows には接続情報が格納されているため、現在切断されているネットワーク接続に関する情報を取得できます。

要件

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