Win32 API 日本語リファレンス
ホーム › NetworkManagement.WNet › PF_NPGetConnection3

PF_NPGetConnection3

コールバック

シグネチャ

DWORD PF_NPGetConnection3(
    LPWSTR lpLocalName,
    DWORD dwLevel,
    void* lpBuffer,
    DWORD* lpBufferSize
);

パラメーター

フィールド型説明
lpLocalNameLPWSTR呼び出し元が対象とするローカル デバイスの名前へのポインターです。プロバイダーは、これが構文的に正しいものと想定できます。
dwLevelDWORD

ネットワーク接続が現在接続されているか、切断されているかを指定する値です。

値 意味
WNGETCON_CONNECTED
 ネットワーク接続は接続されています。
WNGETCON_DISCONNECTED
 ネットワーク接続は切断されています。
lpBuffervoid*要求された情報を格納するバッファーを受け取る void ポインターです。
lpBufferSizeDWORD*lpBuffer バッファーのサイズ (文字数) へのポインターです。バッファーが十分な大きさでないために呼び出しが失敗した場合、lpBufferSize には必要なバッファー サイズが設定されます。

公式ドキュメント

現在切断されている場合でも、ネットワーク接続に関する情報を取得します。

戻り値

関数が成功した場合は、WN_SUCCESS を返します。

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

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

解説(Remarks)

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

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)