現在切断されている場合でも、ネットワーク接続に関する情報を取得します。
構文
DWORD NPGetConnection3(
[in] LPCWSTR lpLocalName,
[in] DWORD dwLevel,
[out] LPVOID lpBuffer,
[in, out] LPDWORD lpBufferSize
);
パラメーター
[in] lpLocalName
呼び出し元が関心を持っているローカル デバイスの名前へのポインター。 プロバイダーは、これが構文的に有効であると想定できます。
[in] dwLevel
ネットワーク接続が現在接続されているか切断されているかを指定する値。
| 価値 | Meaning |
|---|---|
|
ネットワーク接続が接続されています。 |
|
ネットワーク接続が切断されています。 |
[out] lpBuffer
要求された情報を含むバッファーを受け取る Void ポインター。
[in, out] lpBufferSize
lpBuffer バッファーのサイズ (文字単位) へのポインター。 バッファーが十分な大きさではないために呼び出しが失敗した場合、 lpBufferSize は必要なバッファー サイズに設定されます。
戻り値
関数が成功すると、WN_SUCCESSが返されます。
関数が失敗した場合は、次のいずれかの値を返す必要があります。
| リターン コード | Description |
|---|---|
|
lpLocalName で指定されたデバイスは、このプロバイダーによってリダイレクトされません。 |
|
バッファーが小さすぎて、すべてのデータを受信できませんでした。 |
|
ネットワークが存在しません。 |
注釈
ネットワーク接続は、接続済み、切断済み、使用不可の 3 つの状態で存在できます。 NPGetConnection3 関数は、現在使用できないネットワーク接続に関する情報を取得できません。 ただし、Windows には接続情報が格納されるため、現在切断されているネットワーク接続に関する情報を取得できます。
Requirements
| Requirement | 価値 |
|---|---|
| サポートされる最小クライアント | Windows XP [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2003 [デスクトップ アプリのみ] |
| ターゲット プラットフォーム の | ウィンドウズ |
| Header | npapi.h |
| Library | nanosrv.lib |